Clay

Name: Clay
Author: clay-inc

@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

Basic information

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

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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.