The Clay MCP Server enables AI assistants to interact with your Clay contact management system for comprehensive contact search, management, and relationship tracking.
Contact Search & Discovery: Search contacts by job title, company, location, skills, keywords, interaction history, or relationship strength. Retrieve detailed contact information including emails, phone numbers, social links, and notes. Exclude previously shown results when requesting more contacts.
Statistics & Analytics: Generate numerical statistics and percentages about your network (e.g., "how many contacts work at X company" or "what percentage are engineers"). Aggregate and analyze contact distribution across companies, locations, or job titles.
Interaction Tracking: Search past interactions to identify frequently contacted people, recently added contacts, and strongest connections based on relevance scores. Sort by interaction frequency, recency, or alphabetically.
Contact Management: View detailed contact information, create new contacts with comprehensive details (name, email, phone, job title, company, birthday, LinkedIn, website), and add notes to existing contacts for follow-ups and reminders.
Group Management: Retrieve all contact groups, create new groups, update group names, and add or remove multiple contacts from groups in bulk.
Notes & Events: Access notes created within specific date ranges and fetch meetings/events scheduled within specified time periods.
Advanced Filtering: Use complex queries with AND/OR logic, date-based filtering (specific dates, ranges, relative dates like "last week"), and multiple criteria including location, job title, company name, and keyword extraction for skills, interests, and expertise.
Clay MCP Server
A simple Model Context Protocol (MCP) server for Clay.
Demo Video
Related MCP server: WebSearch
Getting Started
Via Smithery (preferred)
Visit Clay's Smithery page, choose your preferred client (e.g. Claude, ChatGPT, Poke, Cursor, Raycast, etc.) and enter your Clay API key.
Follow Smithery's instructions to configure the server URL with your preferred client.
Manual installation (expert mode)
To self-host the MCP on your local computer for Claude:
Edit your
claude_desktop_config.json(in the Claude Desktop app, go to Preferences > Developer > Edit Config)Add the Clay MCP server as below:
Features
Contact Search: Find contacts by job title, company, location, or specific keywords.
Interaction Search: Retrieve past interactions based on various criteria.
Contact Statistics: Obtain numerical statistics and percentages related to your contacts.
Detailed Contact Info: Access comprehensive information for a specific contact by ID.
Add New Contact: Create new contacts with details like name, phone, email, and more.
Add Contact Note: Create a note associated with a specific contact.
Retrieve Groups: Get all user-defined groups or lists.
Create New Group: Create a new group or list.
Update Group: Update a group's title or modify its members.
Retrieve Notes: Get notes created within a specified date range.
Retrieve Events: Fetch meetings and events scheduled within a specified date range.
Examples
"Who in my network works at Google as a Product Manager?"
"Who have I emailed the most this year?"
"How many of my contacts are based in New York?"
"Who is John Smith?"
"Add a new contact named Jane Doe, who is a Designer at Figma."
"Save a note for John Smith: 'Follow up about the Q2 report.'"
"Create a group called 'Investors 2025.'"
"Add Jane Doe and John Smith to the Investors 2025 group."
"What notes did I take last week?"
"What meetings do I have scheduled for tomorrow?"
More information
Learn more and reach out at the Clay Library.