How to Use the Attio MCP in Claude

Q: Can Claude Desktop read custom Attio objects?

Yes. The listobjects tool dynamically fetches your specific workspace structure. Claude sees custom tables exactly the same way it sees default accounts.

Q: Why does my Attio integration in Claude Desktop fail to connect?

Authentication usually causes this. Run the getaccountcheck tool to verify your workspace connection is active. Ensure your API token has the correct read and write permissions.

Connect Claude Desktop to your CRM via this MCP server and manage sales records directly from your chat interface.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Attio MCP to Claude Desktop

Create your Vinkius account to connect Attio to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Attio with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Query your CRM via MCP Server

`query_records` grabs precise sales data straight from your workspace. Ask Claude to find deals closing this month, and it pulls the raw objects right into the context window. You stop switching tabs to check pipeline status. Need a broader look? `search_records` runs a global fuzzy search across all your tables. Type a partial client name or an old contact email. The agent finds the exact match without requiring strict formatting.

Inspect objects and attributes

`list_objects` maps out your entire database structure. Claude reads the exact tables you have configured, whether standard accounts or custom lead trackers. It knows exactly what fields exist before trying to write data. Drilling down further, `list_attributes` exposes every column for a specific object. `get_object` pulls the metadata. Your agent builds a complete map of your schema so it never tries to insert a string into an integer field.

Create and update records instantly

`create_record` pushes new entries directly into your database via MCP. Drop a meeting transcript into Claude Desktop and tell it to extract action items into a new deal object. The agent handles the API calls in the background. Updating existing data works just as well. `assert_record` checks if a contact exists, updates their title if they got promoted, or creates a fresh profile if they are new. `get_record` confirms the changes stuck.

Setup guide

Set up Attio MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Attio MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Attio MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under attio-mcp.

json

{
  "mcpServers": {
    "attio-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Attio. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Attio now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Attio MCP in Claude Desktop

Open your Claude settings and navigate to Developer options. Edit your claude_desktop_config.json file to include the server details under the mcpServers key. Restart the application to load the tools.

Yes. The list_objects tool dynamically fetches your specific workspace structure. Claude sees custom tables exactly the same way it sees default accounts.

Authentication usually causes this. Run the get_account_check tool to verify your workspace connection is active. Ensure your API token has the correct read and write permissions.

You can plug the remote MCP server URL directly into claude.ai via Custom Connectors. Go to Settings, click Integrations, and paste the endpoint. It works across all paid and free tiers.

Vinkius isolates your pipeline records inside a V8 sandbox. The server processes contact details and deal sizes ephemerally during the request, then immediately destroys the execution environment. We never store your customer relationships on our disks.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript