Work from real CRM context
Let assistants use the accounts, contacts, leads, deals, products, and activities already in your workspace.
CRM with MCP integration
Connect ChatGPT, Claude.ai, Claude Code, Cursor, Codex, and other compatible clients to Anvil CRM through OAuth 2.1. Choose one workspace, grant explicit scopes, and keep every action inside the member's live permissions.
No card details required.
MCP gives AI assistants a structured way to interact with Anvil. Your team can use a compatible assistant to read, create, update, and analyze CRM records while Anvil's existing workspace permissions keep access scoped to the right people and data.
Built for the day-to-day
Let assistants use the accounts, contacts, leads, deals, products, and activities already in your workspace.
Ask for reports, identify next actions, research account context, and create workflows that fit the way your team sells.
MCP actions respect the workspace access and permissions configured in Anvil.
What is an MCP CRM?
The Model Context Protocol gives an AI client a standard way to discover and call tools. Anvil's remote MCP server describes CRM objects, readable fields, filters, and allowed actions. The assistant receives structured results instead of browser access or database credentials.
Every connection is bound to one workspace during OAuth consent. Anvil then intersects the token scopes with the stored grant, workspace switches, plan entitlements, role permissions, record visibility, and pipeline access on every call. A scope can narrow access; it cannot grant authority the member does not already have.
Connection sequence
On Pro, a workspace admin turns on agent access under Settings → AI agents. Write access remains a separate switch and can stay off.
Configure the client with https://app.anvilcrm.com/api/mcp. Anvil publishes OAuth authorization and protected-resource metadata for discovery.
Sign in, select exactly one workspace, and approve read, write, correction, or delete scopes. The client never chooses a tenant from unverified input.
Call whoami first to see the workspace, effective scopes, CRM access, and permission matrix. Use discovery tools before sending record fields.
Remote MCP endpoint
https://app.anvilcrm.com/api/mcpOAuth scopes
| Scope | Allows | Important boundary |
|---|---|---|
anvil:read | Object discovery, records, activities, timelines, pipeline summaries, and reports | Results still follow record, field, pipeline, and module permissions |
anvil:write | Create and update CRM records, activities, relationships, lifecycle actions, and commercials | Disabled when the workspace write switch is off; writes use revision or idempotency controls |
anvil:correct | Audited corrections to current or historical deal closure episodes | Separate from ordinary write access because it changes commercial history |
anvil:delete | Delete a record or activity occurrence | Requires an explicit confirmation flag; CRM record deletion is soft deletion |
Tool coverage
Use list_objects and describe_object to learn available object types, fields, list columns, filters, and write contracts instead of guessing payloads.
Search or list records, inspect activities and timelines, get pipeline summaries, and find work that needs attention within the caller's visibility.
Create records and tasks with idempotency keys. Update existing records with their expected revision so a stale assistant cannot overwrite a newer human change.
Preview stage, close, reopen, conversion, ownership, and commercial actions before applying them. Dedicated tools preserve required values and lifecycle history.
Example requests
“Show the open deals I can see that have no completed activity in the last 14 days. Do not change anything.”
“Summarize the visible timeline for Meridian Systems and list unresolved next actions with their owners.”
“Preview moving this deal to Proposal and tell me which values or permissions are missing. Do not apply the change.”
“Draft five follow-up tasks from this pipeline review. Show the proposed titles, owners, and due dates before creating them.”
Safeguards and limitations
Every call re-checks membership, roles, record access, pipeline visibility, plan entitlements, scopes, and workspace agent switches.
Deletion and workspace-structure tools require the assistant to restate the change, obtain confirmation in the same turn, and send confirm: true.
Tool calls record the grant, member, client, tool, outcome, duration, and touched record IDs, but not prompts, inputs, results, or field values.
A member can revoke their grant and an admin can revoke any workspace grant. Disabling workspace access or removing membership also blocks calls.
Lists are paginated, request and response sizes are capped, rate limits apply, and writes use revision fences or idempotency keys.
The server enforces authorization and data contracts; it cannot guarantee that an assistant's interpretation, summary, or proposed business decision is correct.
Continue evaluating Anvil
Frequently asked questions
An MCP CRM connects to AI assistants through the Model Context Protocol, giving them structured access to CRM tools and data within defined permissions.
Anvil MCP uses the remote streamable HTTP transport and works with compatible clients including ChatGPT, Claude.ai, Claude Code, Cursor, and Codex. Client support changes independently, so confirm that your chosen client supports remote MCP servers and OAuth.
Depending on its OAuth scopes and the member's live permissions, an assistant can inspect CRM structure, search and read records, review pipelines and timelines, create or update records and activities, run reports, and perform explicitly confirmed structure or deletion actions.