What does the Clay MCP Server do?
It acts as a bridge between Clay’s CRM platform and MCP-compatible AI assistants, enabling natural-language commands to manage contacts, groups, notes, and events.
Clay MCP Server
@clay-inc
基本信息
关于 Clay MCP Server
A Model Context Protocol (MCP) server for Clay (clay.earth). Search your email, calendar, Twitter / X, Linkedin, iMessage, Facebook, and WhatsApp contacts. Take notes, set reminders, and more.
Clay MCP Server 配置
使用下面的配置,将此服务器添加到你的 MCP 客户端。
{
"mcpServers": {
"clay-mcp": {
"command": "npx",
"args": [
"@clayhq/clay-mcp@latest"
],
"env": {
"CLAY_API_KEY": "YOUR_CLAY_API_KEY"
}
}
}
}Clay MCP Server 工具
11Search for contacts and return matching people. Use for questions about specific contacts or "who" questions (e.g. "Who did I meet most?" or "who works as an engineer?"). Returns actual contact records for queries needing specific people.
Search for interactions and return matching interactions. Use for questions about specific interactions, "who" questions (e.g. "Who did I meet most?"), finding best friends based on relevance score, or finding recently added/created contacts. Returns actual contact records for queries needing specific interactions.
Get numerical statistics and counts ONLY. Returns numbers and percentages, never specific contacts. For counting questions like "how many work at Google?" or "what % are engineers?". Use search endpoint instead for any "who" questions or to get actual contact details.
Get details for a contact by id, including emails, social links, phone numbers, and notes.
Create a new contact record in Clay. This endpoint should only be used when you need to create a completely new contact, not for adding contacts to groups.
Create a note for a contact. Only use this when the user explicitly asks to create, add, or save a note.
Get all groups or lists for the user.
Create a group or list for the user. If a group with the same name already exists, it will not create a duplicate unless explicitly requested to ignore the check.
Update a group or list. Use this to update the group title and/or modify its members. When adding or removing contacts, provide ALL contact IDs to add/remove in a single call - do not make multiple calls for individual contacts.
Use ONLY when the user explicitly mentions "note" or "notes" to retrieve notes between two dates (e.g. "what notes from last week?"). Returns notes by creation date only - does NOT search note content or filter by other criteria. NEVER use this tool for finding contacts or any other purpose besides retrieving notes. This tool is strictly prohibited from being used unless "note" or "notes" are explicitly mentioned in the query.
Use this tool ONLY to fetch meetings/events in a date range (e.g. "what meetings next week?", "show calendar for tomorrow"). DO NOT use for counting meetings, analyzing patterns, or finding frequent participants.
概览
What is Clay?
The Clay MCP Server is a Model Context Protocol (MCP) server that connects Clay’s contact and network management platform to AI assistants. It lets users search, create, and manage contacts, groups, notes, and events through natural language commands via MCP-compatible clients like Claude Desktop.
How to use Clay?
Install via Smithery (fastest) by generating a Clay API key, visiting Clay’s Smithery page, and entering the key. Alternatively, manually add the server to claude_desktop_config.json with the npx @clayhq/clay-mcp@latest command and your CLAY_API_KEY. Once configured, you can ask your AI assistant to perform various CRM actions.
Key features of Clay
- Contact search by job title, company, location, or keywords
- Interaction search with customizable criteria
- Contact statistics (counts and percentages)
- Detailed contact information by ID
- Add new contacts with name, phone, email, and more
- Add notes to specific contacts
- Retrieve user-defined groups/lists
- Create and update groups (title and members)
- Retrieve notes within a date range
- Fetch meetings and events within a date range
Use cases of Clay
- Find contacts matching specific job titles, companies, or locations
- Get statistics on contact distribution (e.g., location, interaction frequency)
- Create and manage contact groups for targeted outreach
- Log notes and follow-ups on individual contacts
- Retrieve upcoming meetings and past notes for review
常见问题
What do I need to run Clay?
A Clay account and API key (generated from your Clay settings), plus Node.js (npx) to run the MCP server. No additional databases or services are required.
How do I install the Clay MCP Server?
The fastest method is through Smithery: get your Clay API key, then use the Smithery installation command. Alternatively, manually add the server configuration to your Claude Desktop config file and supply the API key via environment variable.
What actions can I perform with Clay?
You can search contacts and interactions, view contact statistics, add new contacts and notes, create and update groups, and retrieve notes and events within defined date ranges.
Which AI assistants work with Clay?
The server is designed for any MCP-compatible client. The README demonstrates usage with Claude Desktop and provides installation instructions for Claude’s configuration.
沟通协作 分类下的更多 MCP 服务器
uplika
uplikaHosted MCP server that lets your AI agent post to Threads, Instagram, YouTube, Facebook, TikTok, Pinterest, Bluesky, Telegram, Discord, Ghost and Naver Blog. Setup for each agent.
SendRaven
CommonNinjaSendRaven is email infrastructure for AI agents. Send, read replies as threads, run campaigns and automations, with limits on the API key.
1
Soprano Connect MCP Server
soprano-mcpSoprano Connect MCP Server enables you to build AI agents that can communicate, engage customers, and manage communications workflows through the Soprano Connect platform using the Model Context Protocol (MCP).
Agent Inbox
Agent InboxGive your agent an inbox. Its own address on email, Slack and Telegram. A product of Novu
atbridge.ai
atbridge-aiLocal MCP server for Thunderbird. Gives Claude Desktop, Cursor, or any MCP client read/write access to multiple mailboxes, calendars, contacts, notes & tasks (Gmail, Outlook, IMAP) — all on your machine.
评论