Clay

@clay-inc

About Clay

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.

#contacts #crm #productivity

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "clay-mcp": {
      "command": "npx",
      "args": [
        "@clayhq/clay-mcp@latest"
      ],
      "env": {
        "CLAY_API_KEY": "YOUR_CLAY_API_KEY"
      }
    }
  }
}

Tools

Search 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.

Overview

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

FAQ from Clay

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.

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.

Frequently asked questions

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.

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?

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.

Comments

Basic information

More Communication MCP servers

WhatsApp MCP Server

lharries

WhatsApp MCP server

5.9K

Discord Mcp

SaseQ

A MCP server for the Discord integration. Enable your AI assistants to seamlessly interact with Discord. Enhance your Discord experience with powerful automation capabilities.

387