Attio MCP Server

Run a lightweight health probe that echoes deployment metadata. Never query Attio APIs, mutate data, or require credentials. Accepts optional echo text; returns JSON payload as text for MCP clients. If unavailable, review Smithery sandbox logs or restart the server process.

[DEPRECATED] This tool has been consolidated into 'manage-list-entry'.

Please use 'manage-list-entry' with Mode 1 (Add) parameters instead:

• Pass 'recordId', 'objectType', and optionally 'initialValues'
• All functionality remains identical

This tool will be removed in version 2.0.0.

Add company or person to list with optional initial values. Never create records; record must exist first. May require explicit user approval from the host. Requires list UUID, record UUID, object type. If not found, create record first with create-record.

[DEPRECATED] This tool has been consolidated into 'filter-list-entries'.

Please use 'filter-list-entries' with Mode 2 (Advanced) parameters instead:

• Pass a 'filters' object with 'filters' array and 'matchAny' flag
• All functionality remains identical

This tool will be removed in version 2.0.0.

---

Filter entries with multi-condition queries (AND/OR logic). Never modify entries; read-only. Requires listId, filters array; matchAny for OR logic. Use filter-list-entries for single conditions.

Execute batched record operations (create/update/delete/get/search). Never ignore approval guardrails; hosts may require confirmation. May require explicit user approval from the host. Use scoped single-record tools for one company or deal write. operation_type must be specified for legacy payloads; operations arrays must use explicit create/update/delete entries. Run records.search first to stage IDs or payloads for batching.

Execute multiple searches in parallel and return grouped results. Never mutate or import data; use records.batch for write operations. Provide queries array (1–10 items recommended) and resource_type. If queries fail, retry individually using records.search.

Create one company in Attio without choosing resource_type. Never update existing companies or create deals, people, or tasks. May require explicit user approval from the host. Requires record_data with company attribute API slugs such as name, domains, or website. If fields are rejected, call discover_record_attributes with resource_type companies.

Create one deal in Attio without choosing resource_type. Never update existing deals or create companies, people, or tasks. May require explicit user approval from the host. Requires record_data with deal attribute API slugs such as name, stage, value, owner, or associated company/person references. If stage or owner values are rejected, call discover_record_attributes or get_record_attribute_options for deals.

Create note for companies, people, or deals with full markdown support. Never update or delete notes; creates only. May require explicit user approval from the host. Requires resource_type, record_id, title, content. Set format="markdown" for rich formatting: headings (# ## ###), lists (- or 1.), nested bullets (2-space indent), bold (text), code blocks. Use \n for line breaks. If record not found, use records_search first.

Create new Attio records across supported resource types when a scoped tool is not available. Prefer create_company or create_deal for common company/deal writes. Never update existing records, attach files, or bypass required fields. May require explicit user approval from the host. Requires resource_type plus record_data that matches discover_record_attributes output. If validation fails, call records_discover_attributes to confirm required fields and enums. If a select/status value is rejected, call records_get_attribute_options for that attribute to list valid options before retrying.

Create a new CRM list (sales pipeline, recruiting tracker, support queue). Supports templates for quick setup with smart defaults. Never update existing lists or manage list entries. Requires name and parent_object. Template expansion fills defaults before validation. Dry-run mode previews without creating. Use get-lists to verify the list was created. Use update-list-configuration to modify after creation.

Delete an Attio record from its object (company, person, deal, task). Never cascade delete related data or clean up list memberships automatically. May require explicit user approval from the host. Requires record_id and resource_type; operation is irreversible once confirmed. If uncertain, fetch with records_get_details to confirm the target before deletion.

Discover available attributes (standard/custom) for a resource. Never alter schema or create fields. Requires resource_type; optional categories selects subsets. For select/status attributes, use get_record_attribute_options to fetch valid values before creating or updating records.

Return the canonical Attio record payload for a search connector reference. Never perform write operations or resolve IDs not emitted by the search tool. Accepts identifier generated by search (<resource>:<uuid>) and returns JSON serialized as text. If fetch fails, rerun search to refresh the identifier or verify the record still exists.

Filter list entries with flexible parameter modes. Auto-detects mode based on parameters provided.

Mode 1 - Simple Filtering (Single Attribute): Filter entries by a single attribute condition. Required parameters: listId, attributeSlug, condition, value

Example: { "listId": "550e8400-e29b-41d4-a716-446655440000", "attributeSlug": "status", "condition": "equals", "value": "active" }

Mode 2 - Advanced Filtering (Multi-Condition): Filter entries with multiple conditions using AND/OR logic. Required parameters: listId, filters (object with filters array and matchAny flag)

Example: { "listId": "550e8400-e29b-41d4-a716-446655440000", "filters": { "filters": [ {"attribute": {"slug": "status"}, "condition": "equals", "value": "active"}, {"attribute": {"slug": "priority"}, "condition": "greater_than", "value": 5} ], "matchAny": false } }

Mode 3 - Parent Attribute Filtering: Filter entries by parent record attributes (e.g., company industry, person role). Required parameters: listId, parentObjectType, parentAttributeSlug, condition, value

Example: { "listId": "550e8400-e29b-41d4-a716-446655440000", "parentObjectType": "companies", "parentAttributeSlug": "categories", "condition": "contains", "value": "Technology" }

Mode 4 - Parent UUID Filtering: Filter entries by exact parent record UUID (convenience mode, fastest). Required parameters: listId, parentRecordId

Example: { "listId": "550e8400-e29b-41d4-a716-446655440000", "parentRecordId": "660e8400-e29b-41d4-a716-446655440001" }

Mode Detection: The tool automatically detects which mode to use based on the parameters you provide. You must provide parameters for exactly ONE mode per call.

Pagination: All modes support optional 'limit' and 'offset' parameters for pagination.

Migration Guide:

• Replaces: advanced-filter-list-entries → Use Mode 2 (filters parameter)
• Replaces: filter-list-entries-by-parent → Use Mode 3 (parentObjectType + parentAttributeSlug)
• Replaces: filter-list-entries-by-parent-id → Use Mode 4 (parentRecordId)

[DEPRECATED] This tool has been consolidated into 'filter-list-entries'.

Please use 'filter-list-entries' with Mode 3 (Parent Attribute) parameters instead:

• Pass 'parentObjectType', 'parentAttributeSlug', 'condition', and 'value'
• All functionality remains identical

This tool will be removed in version 2.0.0.

---

Filter entries by parent record attributes (industry, role). Never search multiple lists or modify records. Requires listId, parentObjectType, parentAttributeSlug, condition, value. Use records_discover_attributes for valid slugs.

[DEPRECATED] This tool has been consolidated into 'filter-list-entries'.

Please use 'filter-list-entries' with Mode 4 (Parent UUID) parameters instead:

• Pass 'parentRecordId' parameter
• Note: Parameter renamed from 'recordId' to 'parentRecordId' for consistency
• All functionality remains identical (fastest filtering mode)

This tool will be removed in version 2.0.0.

---

Filter entries by exact parent record UUID. Never search multiple lists. Requires list UUID, record UUID; faster than attribute filtering. Use get-record-list-memberships for workspace-wide search.

Get valid options for select, multi-select, and status attributes to avoid "Cannot find select option" errors. Never return options for text, number, or other non-option types. Requires resource_type and attribute slug/ID. Use discover_record_attributes to find option-based attributes first. Use retrieved option titles when calling create-record or update-record.

Retrieve attribute metadata for a given resource type. Never modify schema definitions or record data. Requires resource_type; optional categories narrows groups. Use records.discover_attributes for grouped schema discovery.

Fetch a single record with enriched attribute formatting. Never search or filter result sets; use records.search* tools instead. Requires resource_type and record_id; optional fields filter output. Validate record IDs with records.search before retrying.

Retrieve enriched info subsets (contact, business, social) for a record. Never search lists of records or mutate data. Requires resource_type, record_id, and info_type (contact|business|social). Use records.get_details if you need the full record payload.

Fetch interaction metadata (first/last email, calendar, interaction timestamps and owners) for a person or company record. Never retrieve full email content or activity feeds; Attio only exposes interaction timestamps and owner actors. Requires resource_type (people or companies) and record_id. Returns system-generated interaction attributes. If no interactions found, verify the record exists with get_record_details. For activity content, use search_records_by_content with content_type=activity.

Retrieve schema and configuration for a specific list (stages, fields, attributes). Never modify list structure or retrieve list entries. Requires valid list UUID or slug; accepts both formats. Use get-lists to discover available list IDs and slugs first.

Retrieve all records in a list with pagination (companies, people in pipelines). Never filter entries or modify list memberships. Requires list UUID (not slug); default limit 20, max per page varies by API. Use filter-list-entries for attribute-based filtering instead.

Retrieve all CRM lists (sales pipelines, lead stages, customer segments). Never create or modify lists, only reads existing lists. Returns all lists visible to the authenticated workspace. Use get-list-details to inspect individual list schemas.

Find all lists containing a specific company or person record. Never modify list memberships or retrieve list entries. Requires recordId; processes 5 lists in parallel by default (max 20). If record not found, verify recordId with records_search first.

Retrieve profile and access details for one workspace member. Never update member information or change permissions. Requires workspace_member_id from list/search results; read-only. Use list-workspace-members to confirm the memberId before retrying.

Retrieve notes for a record with timestamps. Never create or modify notes; read-only. Requires resource_type, record_id; sorted by creation date. If empty, verify record has notes with records_get_details.

List workspace members to plan assignments and access checks. Never change access levels or invite new members; read-only. Supports optional search, pagination (1-100 per page, default 25). Use search-workspace-members for targeted lookups.

Manage list entries with flexible action modes. Auto-detects action based on parameters provided.

Mode 1 - Add Entry (Add record to list): Add a company or person record to a list with optional initial values. Required parameters: listId, recordId, objectType Optional parameters: initialValues

Example: { "listId": "550e8400-e29b-41d4-a716-446655440000", "recordId": "660e8400-e29b-41d4-a716-446655440001", "objectType": "companies", "initialValues": {"stage": "Prospect"} }

Mode 2 - Remove Entry: Remove an entry from a list. Required parameters: listId, entryId

Example: { "listId": "550e8400-e29b-41d4-a716-446655440000", "entryId": "770e8400-e29b-41d4-a716-446655440002" }

Mode 3 - Update Entry: Update attributes on an existing list entry. Required parameters: listId, entryId, attributes

Example: { "listId": "550e8400-e29b-41d4-a716-446655440000", "entryId": "770e8400-e29b-41d4-a716-446655440002", "attributes": {"stage": "Qualified"} }

Mode Detection: The tool automatically detects which action to perform based on the parameters you provide. You must provide parameters for exactly ONE mode per call.

Migration Guide:

• Replaces: add-record-to-list → Use Mode 1 (recordId + objectType)
• Replaces: remove-record-from-list → Use Mode 2 (entryId only)
• Replaces: update-list-entry → Use Mode 3 (entryId + attributes)

[DEPRECATED] This tool has been consolidated into 'manage-list-entry'.

Please use 'manage-list-entry' with Mode 2 (Remove) parameters instead:

• Pass 'entryId' only (do not include 'attributes' or 'recordId')
• All functionality remains identical

This tool will be removed in version 2.0.0.

Remove company or person from list (membership only). Never delete underlying record; membership only. May require explicit user approval from the host. Requires list UUID, entry UUID (not record UUID). Use get-list-entries to find entry UUID.

Run lightweight compatibility search across companies, people, lists, and tasks for ChatGPT MCP. Never support complex filters, batch queries, or return rich record payloads (use records_search* tools). Requires query string (min 1 char); optional type filter; limit up to 25 results per call. When you need pagination or attribute filtering, switch to records_search or records_search_advanced.

Search across companies, people, deals, tasks, and records. Never create or modify records. Returns max 100 results (default: 10). use discover_record_attributes to find searchable fields.

Search companies, people, deals, or tasks with complex nested filters (e.g., find deals by owner+stage, companies by industry+location). Never mutate records; use records.update or records.delete. Supports filter groups, scoring, pagination, and up to 100 items. Requires resource_type parameter. If filters fail, fetch valid attributes via records.discover_attributes.

Search record content (notes, activity, communications). Never modify note content or attachments. Requires resource_type and content_query; optional fields array. Narrow scope with fields or switch to records.search_advanced.

Search records using relationship anchors (list, company, people). Never modify memberships; use list tools for writes. Requires resource_type and related resource identifier. Use records.search to resolve IDs before calling.

Filter records by creation, update, or interaction timeframes. Never modify lifecycle state or scheduling follow-ups. Requires resource_type; provide timeframe or explicit date boundaries. Call records.search if timeframe filters are too restrictive.

Search workspace members by name, email, or access role. Never modify member profiles or permissions; lookup only. Requires query string (minimum 2 characters). If no results, list-workspace-members provides the full roster.

Retrieve non-sensitive diagnostic information about Smithery runtime configuration propagation. Never expose credentials or auth state, write data, or modify configuration. Returns runtime, workspace, and context-storage diagnostics only. Read-only operation. Use this tool to compare runtime mode, workspace configuration, and context storage state across deployments.

Update one company in Attio without choosing resource_type. Never create records, delete records, or update deals. May require explicit user approval from the host. Requires record_id and record_data with company attribute API slugs. Call get_record_details or search_records for companies first to confirm the target company ID.

Update one deal in Attio without choosing resource_type. Never create records, delete records, or update companies. May require explicit user approval from the host. Requires record_id and record_data with deal attribute API slugs. Call search_records for deals first to confirm the target deal ID and current stage.

Update existing Attio record fields across supported resource types when a scoped tool is not available. Prefer update_company or update_deal for common company/deal writes. Never create new records, delete data, or manage list memberships. May require explicit user approval from the host. Requires resource_type, record_id, and record_data; supports partial updates with schema validation. Call records_get_details first to inspect the latest values before editing. If a select/status value is rejected, call records_get_attribute_options for that attribute to list valid options.

Update configuration of an existing list (name, description, custom fields). Detects immutable fields and provides clear errors. Never change parent_object (immutable) or manage list entries. Requires listId. Immutable fields (parent_object) are rejected before the API call. Dry-run mode previews changes. Use get-list-details to inspect current configuration. Use create-list for a different parent_object.

[DEPRECATED] This tool has been consolidated into 'manage-list-entry'.

Please use 'manage-list-entry' with Mode 3 (Update) parameters instead:

• Pass 'entryId' and 'attributes' parameters
• All functionality remains identical

This tool will be removed in version 2.0.0.

Update list entry attributes (stage, status, custom fields). Never update record attributes; use update-record for that. May require explicit user approval from the host. Requires list UUID, entry UUID, attributes object. Use get-list-details for valid attributes and values.