# Attio (verified)

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

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add attio

# Browse available tools
npx -y @smithery/cli@latest tool list attio

# Get full schema for a tool
npx -y @smithery/cli@latest tool get attio create-comment

# Call a tool
npx -y @smithery/cli@latest tool call attio create-comment '{}'
```

## Direct MCP Connection

Endpoint: `https://attio.run.tools`

## Tools (34)

- `create-comment` — Creates a new comment on a record, list entry, or as a reply to an existing comment thread. Provide exactly one of: (pa…
- `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…
- `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 …
- `create-task` — Creates a new task in Attio. Tasks can optionally have a deadline, an assignee (workspace member), and be linked to a r…
- `delete-comment` — Deletes a comment. You can only delete comments that you created. Deleting a parent comment will also delete all of its…
- `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.
- `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 value…
- `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 rep…
- `list-comments` — Lists comments on a record or list entry. Returns paginated top-level comments with up to 5 replies each. If a thread h…
- `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…
- `list-records-in-list` — List entries in a given list with optional filtering and sorting. Returns paginated results.
- `list-records` — List records in a given object with optional filtering and sorting. Returns paginated results.
- `list-tasks` — Lists tasks in the workspace with optional filters. Returns paginated results with task content, completion status, ass…
- `list-workspace-members` — List members in the Attio workspace. Returns a list of matching members with their ID, email address, name, access leve…
- `list-workspace-teams` — List teams in the workspace. Teams are groups of workspace members used primarily for permission management. Returns an…
- `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, min…
- `search-call-recordings-by-metadata` — Searches all call recordings across the workspace by their metadata.
- `search-emails-by-metadata` — Searches emails visible to the user by their metadata.
- `search-meetings` — Search across past and future meetings in the workspace. Returns paginated results with meeting metadata and associated…
- `search-notes-by-metadata` — Searches for notes by their metadata. Useful for finding notes based on parent record, meeting, author (workspace membe…
- `search-records` — Perform a full-text search for records in a given object. Only searches indexed attributes: domains, email addresses, p…
- `semantic-search-call-recordings` — Searches all call recordings across the workspace using semantic similarity.
- `semantic-search-emails` — Searches emails visible to the user using semantic similarity.
- `semantic-search-notes` — Searches all notes across the workspace using semantic similarity.
- `update-list` — Update a list's name or API slug
- `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.
- `upsert-record` — Use this tool to create or update people, companies and other records. A matching attribute is used to search for exist…
- `whoami` — Returns information about the current user's identity and workspace membership, including their email, name, workspace …

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get attio <tool-name>
```
