Advertise
MCP.so
Sign In

Clay MCP Server

@clay-inc

Repository

Basic information

Category

Communication

Transports

stdio

Author

clay-inc

Submitted by

Zachary Hamed

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

#contacts#crm#productivity

Clay MCP Server 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"
      }
    }
  }
}

Clay MCP Server tools

11

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

Frequently asked questions

1

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.

2

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.

3

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.

4

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.

5

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

More Communication MCP servers

Soprano Connect MCP Server

soprano-mcp

Soprano 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).

MailStream

Sponge Labs

The first MCP server for physical mail. Give any MCP-compatible AI agent the ability to send real postcards and letters, verify addresses, manage mailing lists and artwork, and track direct mail campaigns. Remote Streama

Vocenya

GH Business Solutions

Connect an AI assistant to one Vocenya business account: list calls, leads, bookings and chats, add leads, queue compliant AI callbacks and update Do Not Call.https://github.com/gadyamedia/vocenya-mcp

I

Instant Expert

Instant Expert

Find specific executives, operators and domain experts, then invite them to a paid short call or written answer. You pay only if they book or answer.

R

RelayLink

RelayLink lets your AI assistant send briefings to other people's AI assistants. Draft a package from your current conversation, attach files, approve the note, and the recipient's AI gets the full context: decisions, op

Advertise