integrations tools zero

    Zero MCP for your AI agent

    Cogny's Zero integration exposes 26 tools (14 read, 9 write, 3 destructive) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app.

    • 14readonly reads data.
    • 9writecreates or changes something.
    • 3destructivedeletes, removes or replaces something.

    Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations. Plans, approvals and limits

    set it up.

    Add Cogny to your AI client once, then connect Zero in Cogny. Every Zero tool below appears in the client.

    • Claude CodeRun claude mcp add --transport http cogny https://app.cogny.com/mcp, then authorise in the browser.
    • Claude.aiSettings → Connectors → Add custom connector, URL https://app.cogny.com/mcp, then log in and pick your workspace.
    • ChatGPTSettings → Apps → Advanced settings → Developer mode → Create app, URL https://app.cogny.com/mcp, authentication OAuth.
    • CursorIn Cogny, Settings → Data & Integrations → Connect AI Clients shows the block to paste into .mcp.json, with an API key.
    • CodexRun codex mcp add cogny --url https://app.cogny.com/mcp.

    Full setup, and how to undo it

    what each tool does.

    Read 14 · only reads data

    • get_workspaceReadIdentify the Zero workspace(s) your API key can reach — their id, name and domain.
    • list_companiesReadList the companies in your Zero workspace, optionally filtered (e.g. {"name": {"$contains": "YC"}}).
    • get_companyReadGet one company by its Zero company id.
    • list_contactsReadList the contacts in your Zero workspace, optionally filtered (e.g. {"email": {"$endsWith": "@zero.inc"}}).
    • get_contactReadGet one contact by its Zero contact id.
    • list_dealsReadList the deals in your Zero workspace, optionally filtered (e.g. {"value": {"$gte": 10000}, "closeDate": {"$lte": "now()"}}).
    • get_dealReadGet one deal by its Zero deal id.
    • list_pipelinesReadList the sales pipelines in your Zero workspace.
    • list_pipeline_stagesReadList the stages of a pipeline (deals move through these).
    • list_listsReadList the lists in your Zero workspace. `filter_based` true returns dynamic lists, false returns regular lists.
    • list_tasksReadList the tasks in your Zero workspace, optionally filtered (e.g. {"done": false} for open tasks).
    • list_notesReadList the notes in your Zero workspace, optionally filtered.
    • list_meetingsReadList the recorded sales meetings in your Zero workspace (calendar events), optionally filtered.
    • list_sequencesReadList the outreach sequences in your Zero workspace (read-only).

    Write 9 · creates or changes something

    • create_companyWriteCreate a company in Zero.
    • update_companyWriteUpdate a company's fields.
    • create_contactWriteCreate a contact in Zero.
    • update_contactWriteUpdate a contact's fields, including unsubscribing a contact from all messaging.
    • create_dealWriteCreate a deal in Zero.
    • update_dealWriteUpdate a deal's fields.
    • create_taskWriteCreate a task in Zero.
    • update_taskWriteUpdate a task's fields (set done=true to complete it).
    • create_noteWriteCreate a note in Zero. `body` is the note text; optionally attach it to a contact, company or deal by id.

    Destructive 3 · deletes, removes or replaces something

    • archive_companyDestructiveArchive (soft-delete) a company in Zero.
    • archive_contactDestructiveArchive (soft-delete) a contact in Zero.
    • archive_dealDestructiveArchive (soft-delete) a deal in Zero.

    Exact input schemas come from tools/list once Zero is connected; the free plan is enough to check. Missing something? Your agent can ask for it with request_feature.