Attio MCP Server
Official Attio MCP server for CRM data.
What is the Attio MCP Server?
The Attio MCP server gives AI agents structured, permission-aware access to Attio through the Model Context Protocol. With 47 pre-built actions, agents can read, create, and update Attio data on behalf of authorized users.
Willow ships the Attio MCP server as part of an enterprise control plane. Every call runs behind SSO (Okta, Azure AD), enforces RBAC and least-privilege at runtime, writes to a full audit trail, and integrates with Splunk and Loki for SIEM visibility. Connect from Claude Desktop, Claude Code, Cursor, ChatGPT, VS Code, n8n, or any custom agent. Install once, distribute org-wide, and see exactly how Attio is being used by every AI agent in your stack.
Tools
create-activity-record
Create a new record for a given activity, for example one specific phone call. IMPORTANT: Before calling this tool, you should call list-activity-attribute-definitions for the target activity to understand which attributes are available, their types, whether they are required, and (for select/status fields) the valid options. Different attribute types require different value formats - see the 'values' parameter description for details.
create-comment
Creates a new comment on a record, list entry, or as a reply to an existing comment thread. Provide exactly one of: (parent_object + parent_record_id) for records, (parent_list + parent_entry_id) for list entries, or (parent_comment_id) for replies. Email addresses in the content will be automatically converted to @mentions if they match workspace members.
add-record-to-list
Add a record to a list as a new list entry. IMPORTANT: Before calling this tool: 1) You should call list-list-attribute-definitions for the target list to understand which entry attributes are available. 2) You should call list-records or search-records to find the record you want to add to the list. 3) You may call list-lists to find available lists. By default, duplicate entries are prevented - if the record already exists in the list, the existing entry ID is returned. Set allow_duplicates to true to create multiple entries for the same record.
create-list
Creates a new list in Attio. Lists are used to group and track records of a single object type (e.g. a sales pipeline of companies). The list is created without any views. Records can be added to the list with the add-record-to-list tool, and attributes specific to the list can be inspected with the list-list-attribute-definitions tool. Permissions are controlled with workspace_access and workspace_member_access. The calling workspace member is automatically granted full access to the created list and does not need to be included in workspace_member_access. If they are included, their given level applies instead, so some workspace member must then keep full access to the list. Returns the created list's ID.
create-note
Creates a new note attached to a record. Returns the created note's ID.
create-record
Create a new record in a given object. IMPORTANT: Before calling this tool, you should call list-attribute-definitions for the target object to understand which attributes are available, their types, whether they are required, and (for select/status fields) the valid options. Different attribute types require different value formats - see the 'values' parameter description for details.
create-task
Creates a new task in Attio. Tasks can optionally have a deadline, an assignee (workspace member), and be linked to a record (e.g., a person or company). To assign to a workspace member, provide their workspace_member_id. To link to a record, provide both the object type (e.g., "people", "companies") and the record_id together. Returns the created task's ID.
delete-comment
Deletes a comment. You can only delete comments that you created. Deleting a parent comment will also delete all of its replies.
delete-task
Deletes a task. Call list-tasks to find the ID of the task you want to delete.
get-call-recording
Retrieves the full details of a call recording by ID, including its status, timestamps, and complete transcript.
get-email-content
Retrieves the full content/body of an email. Requires the mailbox_id and email_header_id, which can be obtained from email search results.
get-note-body
Get the body of a note by its ID
get-records-by-ids
Retrieve a given set of records by their IDs for a given object. Returns an array of records with their attribute values. If a record is not found, it will not be included in the response.
list-activities
List all activities in the Attio workspace. Activities model things that happen over time, such as phone calls or meetings, and each one holds activity records. Returns activity metadata including ID, API slug, singular and plural nouns, and the schemas the activity extends. Use the query parameter to filter by name or slug.
list-activity-attribute-definitions
List attribute definitions for a given activity
list-activity-records
List records for a given activity, such as phone calls or meetings, with optional filtering and sorting. Returns paginated results. Use this tool to retrieve activity records that match specific criteria. You can filter on attributes using comparison operators, combine filters with AND/OR logic, and sort results by attribute values. Before calling this tool, ensure you know the attribute slugs or IDs for any filters or sorts you want to apply. Use the list-activity-attribute-definitions tool to discover available attributes for an activity.
list-attribute-definitions
List attribute definitions for a given object
list-comment-replies
Lists replies to a comment. Provide the comment_id of a top-level comment to fetch its replies. Cannot be used with reply comments - only top-level comments that were created on records or list entries. All replies in a thread use the same parent comment ID.
list-comments
Lists comments on a record or list entry. Returns paginated top-level comments with up to 5 replies each. If a thread has more replies, use "list-comment-replies" to fetch additional replies. Provide either (parent_object and parent_record_id) to list comments on a record, or (parent_list and parent_entry_id) to list comments on a list entry.
list-list-attribute-definitions
List attribute definitions for a given list
list-lists
List all lists in the Attio workspace. Returns list metadata including ID, name, API slug, and parent object types. Use the query parameter to filter by name or slug.
list-objects
List all objects in the Attio workspace. Objects are the types of record the workspace stores, such as companies, people and deals. Returns object metadata including ID, API slug, singular and plural nouns, and whether the object is a standard Attio object. Use the query parameter to filter by name or slug.
list-records-in-list
List entries in a given list with optional filtering and sorting. Returns paginated results. Use this tool to retrieve entries within a list that match specific criteria. You can filter on attributes using comparison operators, combine filters with AND/OR logic, and sort results by attribute values. Each entry includes the parent record it belongs to and all entry-level attributes.
list-records
List records in a given object with optional filtering and sorting. Returns paginated results. Use this tool to retrieve records that match specific criteria. You can filter on attributes using comparison operators, combine filters with AND/OR logic, and sort results by attribute values. Before calling this tool, ensure you know the attribute slugs or IDs for any filters or sorts you want to apply. Use the list-attribute-definitions tool to discover available attributes for an object.
list-tasks
Lists tasks in the workspace with optional filters. Returns paginated results with task content, completion status, assignees, linked records, and deadlines. Use to find tasks by assignee, completion status, linked record, or date ranges.
list-workspace-members
List members in the Attio workspace. Returns a list of matching members with their ID, email address, name, access level, and team memberships. Use the query parameter to filter by name, email, or team.
list-workspace-teams
List teams in the workspace. Teams are groups of workspace members used primarily for permission management. Returns an array of teams, each with: workspace_team_id, name, description, is_archived, created_at, and members (array of {name, email}).
merge-records
Merges two records of the same object into one. Where both records have a value for the same attribute, the primary record's value takes precedence. Merging produces a NEW record, so `new_record_id` will match neither of the records you supplied. Both original records are marked as merged and can no longer be read or written. Large merges are applied in the background. `merge_status: in_progress` means the merge has been committed but reading the new merged record will fail until it finishes; do not retry the merge, wait a few seconds and then read the record. `merge_status: completed` means the new merged record is readable immediately.
run-basic-report
Run an aggregate report on records in an object or entries in a list. Use this tool when you need totals, averages, minimums, maximums, or grouped breakdowns. How to use: 1. Pick a source object/list via slug or UUID. 2. Choose a metric: - {"type":"count"} for counting records/entries. - {"type":"attribute", ...} for aggregating a numeric attribute. 3. Optionally add filter to narrow rows before aggregation. 4. Optionally add up to two group_by entries. The first is the primary grouping (outer key), the second is secondary (inner key). 5. If required, use the list attribute tools to discover valid attribute slugs for filter, metric paths, and grouping paths. Expected response shape: - group_by = []: plain number string, e.g. "42" or "1034.5" - one group_by: TOON key/value map, e.g. enterprise: 12 smb: 35 - two group_by: nested TOON map, e.g. emea: won: 4 open: 7 na: won: 3
search-call-recordings-by-metadata
Searches all call recordings across the workspace by their metadata. Useful for finding call recordings based on who was on the call (workspace members or person records), related records (e.g., companies or deals), meeting title, and time range. Returns paginated results ordered by start time (most recent first). Uses limit/offset pagination. Returns call recording metadata only (IDs and timestamps). Use the "get-call-recording" tool to retrieve the full transcript of a call recording.
search-emails-by-metadata
Searches emails visible to the user by their metadata. Useful for finding emails based on participants, domain, and time range. The participant and domain filters are meant for external participants: filtering by a workspace member's own address or the company's own domain returns no results, because workspace-connected mailboxes matching the filter are excluded from the search scope. Returns paginated results ordered by sent time (most recent first). Uses cursor pagination: pass the next_cursor value from the previous response to fetch the next page. A page may contain fewer than "limit" emails (even zero) while more results still exist; continue while has_more is true. When both domain and participant_email_addresses are provided, they are ORed together (emails matching either filter are returned). Returns email metadata only (ID, subject, summary, snippet, sender, sent_at). Use the "get-email-content" tool to retrieve the full content of an email.
search-meetings
Search across past and future meetings in the workspace. Returns paginated results with meeting metadata and associated call recording IDs. Useful for finding meetings based on participants, related records, and time range. Results are split into past_meetings (sorted by start time descending) and future_meetings (sorted by start time ascending). Returns call_recording_ids for past meetings so you can fetch full transcripts via the "get-call-recording" tool.
search-notes-by-metadata
Searches for notes by their metadata. Useful for finding notes based on parent record, meeting, author (workspace member), and creation time. Returns paginated results ordered by creation date (most recent first). Uses limit/offset pagination.
search-records
Perform a full-text search for records in a given object. Only searches indexed attributes: domains, email addresses, phone numbers, name/title, description, social handles, and location. Returns paginated results.
semantic-search-call-recordings
Searches all call recordings across the workspace using semantic similarity. Returns call recordings that are most semantically similar to the query, even if the exact keywords are not present in the transcript. Useful for finding calls where a specific topic was discussed. Searches both transcript content and call recording overviews (title and summary) automatically. Returns matching transcript chunks and call recording overview information. Use the "get-call-recording" tool to retrieve the full transcript of a call recording.
semantic-search-emails
Searches emails visible to the user using semantic similarity. Returns up to 20 emails that are most semantically similar to the query, even if exact keywords are not present. Useful for finding emails where a specific topic was discussed. Returns email metadata only (ID, subject, summary, snippet, sender, sent_at). Use the "get-email-content" tool to retrieve the full content of an email.
semantic-search-notes
Searches all notes across the workspace using semantic similarity. Returns up to 20 notes that are most semantically similar to the query, even if the exact keywords are not present in the note. Useful for finding notes where a specific topic was discussed. Returns note metadata only (ID, title, timestamps, parent record). Use the "get-note-body" tool to retrieve the full content of a note.
update-activity-record
Use this tool to update activity records, such as phone calls or meetings, by `record_id`.
update-list-entry-by-id
Update attribute values on an existing list entry by its entry ID. Before calling this tool, you must: - Call list-records-in-list to find the entry you want to update. You may also: - Call list-list-attribute-definitions for the target list to understand which entry attributes are available. - Call list-lists to find available lists. Note: The parent record cannot be changed after creation.
update-list-entry-by-record-id
Update attribute values on a list entry by finding it via its parent record ID. IMPORTANT: This tool will error if the record has zero or multiple entries in the specified list. Before calling this tool, you may: 1) Call list-lists to find available lists. 2) Call list-list-attribute-definitions for the target list to understand which entry attributes are available. 3) Call list-records or search-records to find the record ID.
update-list
Update a list's name, API slug, or permissions.
update-note
Appends or prepends plain-text content to an existing note and/or updates its title. At least one of `operation` or `updated_title` must be provided.
update-record
Use this tool to update people, companies, and other records by `record_id`.
update-task
Updates an existing task in Attio. You can update the deadline, completion status, assignee, and linked record. To update the assignee, provide their workspace_member_id. To update the linked record, provide both the object type (e.g., "people", "companies") and the record_id together. To clear the deadline, set deadline_at to null. Returns the updated task's ID.
upsert-activity-record
Use this tool to create or update activity records, such as phone calls or meetings. A matching attribute is used to search for existing activity records. If a record is found with the same value for the `matching_attribute`, that record will be updated. If no record with the same value for the `matching_attribute` is found, a new record will be created instead. If the matching attribute is a multiselect attribute, new values will be added and existing values will not be deleted. The `matching_attribute` must be a unique attribute of the activity. Use the `list-activity-attribute-definitions` tool to find one. If you would like to avoid matching, please use the `create-activity-record` tool.
upsert-record
Use this tool to create or update people, companies and other records. A matching attribute is used to search for existing records. If a record is found with the same value for the `matching_attribute`, that record will be updated. If no record with the same value for the `matching_attribute` is found, a new record will be created instead. If the matching attribute is a multiselect attribute, new values will be added and existing values will not be deleted. If you would like to avoid matching, please use the `create-record` tool.
whoami
Returns information about the current user's identity and workspace membership, including their email, name, workspace member ID, access level, workspace name, and the teams they belong to.
Customize Tools
Edit descriptions, modify arguments, select tools, or add new ones
Set Up Your Attio MCP Server in Minutes
Add the following configuration to your MCP client. Authentication is handled via OAuth. Compatible with Claude Desktop, Claude Code, Cursor, ChatGPT, VS Code, n8n, and any MCP-compatible agent.
Claude Desktop
{
"mcpServers": {
"willow-attio-official": {
"type": "http",
"url": "https://<org>.mcp-s.com/mcp/mcp/attio-official"
}
}
}Cursor
{
"mcpServers": {
"willow-attio-official": {
"type": "http",
"url": "https://<org>.mcp-s.com/mcp/mcp/attio-official"
}
}
}Claude Code
claude mcp add willow-attio-official --transport http https://<org>.mcp-s.com/mcp/mcp/attio-officialn8n
{
"url": "https://<org>.mcp-s.com/mcp/mcp/attio-official",
"method": "POST"
}Or click "Install with Willow" above to set up automatically with SSO and RBAC preconfigured.
Enterprise Governance for Attio
Willow adds the layer Attio and every other SaaS doesn't ship out of the box: every call runs behind SSO (Okta, Azure AD), enforces RBAC and least-privilege at runtime, writes to full audit logs, and detects shadow AI usage across your stack. One MCP gateway. Any agent. Every tool.
Attio MCP Server FAQ
What is the Attio MCP server?
The Attio MCP server is a Model Context Protocol implementation that lets AI agents like Claude, Cursor, and ChatGPT read and write Attio data through a standardized interface. Willow hosts and governs this server so enterprises can roll it out without a security review backlog.
How is Willow's Attio MCP server different from the official one?
The official Attio MCP server is scoped to a single user's account and does not include enterprise governance. Willow's version adds SSO, RBAC, audit logging, shadow AI detection, and centralized control over which actions agents can take across the entire org.
Which AI clients work with the Attio MCP server?
Claude Desktop, Claude Code, Cursor, ChatGPT, VS Code with MCP support, n8n, and any custom agent built with OpenAI Agents SDK, LangChain, Vercel AI SDK, or Anthropic SDK.
Is the Attio MCP server secure? How does Willow handle authentication?
Every call runs behind your existing SSO (Okta, Azure AD). Per-user OAuth scopes the agent to exactly what that user can do in Attio, nothing more. No credentials reach the LLM. Every action writes to an audit trail.
Can I limit which Attio actions agents can take?
Yes. Willow lets you scope agents to specific actions, specific projects, or specific environments. Toggle actions on or off in the dashboard, or enforce policy via infrastructure-as-code through GitHub.
How do I detect shadow Attio MCP servers in my org?
Willow's browser extension and discovery service surface unmanaged MCP servers, skills, and AI agents across the org. If a developer installed an unapproved Attio MCP locally, you'll see it.
What does the Attio MCP server cost?
Pricing depends on org size and deployment model (SaaS, dedicated cloud, self-host). See withwillow.ai/pricing or contact sales for a quote.
How do I install the Attio MCP server with Willow?
Install via the Willow Connect Panel in one click, or paste the JSON snippet above into your Claude Desktop, Cursor, or Claude Code config. SSO and RBAC inherit from your existing Willow setup.
Compare Willow MCP Gateway
See how Willow stacks up against other MCP platforms on governance, security, and enterprise readiness.
Your agents are already in the wild.
Give them a Basecamp. Go from AI chaos to AI work, in minutes.