# Attio — how to use (mcp.ai)

Attio is a fully customizable workspace for your team's relationships and workflows.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_attio?ms=1781542080000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `attio_create_note`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/attio`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/attio/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/attio/create/note` — This tool creates a new note on a given record in attio. the note can be attached to any record type (like person, company, or deal) and includes a title and content. it requires parameters such as pa
  - body: { title: string, content: string, created_at?: string, parent_object: string, parent_record_id: string }
- `POST https://api.mcp.ai/api/attio/create/record` — This tool creates a new record in attio for a specified object type (people, companies, deals, users, workspaces, etc.). it requires the object type and a values dictionary containing the attributes f
  - body: { values: object, object_type: string }
- `POST https://api.mcp.ai/api/attio/delete/note` — This tool allows users to delete a specific note in attio by its id. it is implemented via delete https://api.attio.com/v2/notes/{note id} and handles note deletion by validating the provided note id.
  - body: { note_id: string }
- `POST https://api.mcp.ai/api/attio/delete/record` — This tool allows you to delete a record from attio permanently. the deletion is irreversible, and the data will eventually be removed from the system.
  - body: { record_id: string, object_type: string }
- `POST https://api.mcp.ai/api/attio/find/record` — This tool allows users to find a record in attio by either its unique id or by searching using unique attributes. it provides two methods: one for directly retrieving a record by its id with the get /
  - body: { limit?: integer, offset?: integer, object_id: string, record_id?: string, attributes?: object }
- `POST https://api.mcp.ai/api/attio/get/object` — This tool retrieves detailed information about a specific object type in attio, including all its attributes and their properties. this is useful for understanding what fields are available when creat
  - body: { object_id: string }
- `POST https://api.mcp.ai/api/attio/list/lists` — This tool retrieves all lists available in the attio workspace. the lists are returned sorted as they appear in the sidebar. this tool is essential for managing and navigating lists, and is a prerequi
- `POST https://api.mcp.ai/api/attio/list/notes` — This tool lists all notes associated with a specific record in attio. notes are returned in reverse chronological order (newest first).
  - body: { limit?: integer, parent_object: string, parent_record_id: string }
- `POST https://api.mcp.ai/api/attio/list/objects` — This tool retrieves a list of all available objects (both system-defined and user-defined) in the attio workspace. it makes a get request to the /v2/objects endpoint and returns a json response contai
- `POST https://api.mcp.ai/api/attio/list/records` — This tool lists records from a specific object type in attio. it provides simple pagination support and returns records in the order they were created. for complex filtering, use the findrecord action
  - body: { limit?: integer, offset?: integer, object_type: string }
- `POST https://api.mcp.ai/api/attio/update/record` — This tool updates an existing record in attio for a specified object type (people, companies, deals, users, workspaces, etc.). it uses patch to partially update only the provided fields, leaving other
  - body: { values: object, record_id: string, object_type: string }

## More
- Page: https://mcp.ai/attio
- Agent spec (llms.txt): https://mcp.ai/attio/llms.txt
- Postman collection: https://mcp.ai/attio/postman.json