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.
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.