Unofficial Dex CRM MCP Server

An MCP (Model Context Protocol) server that exposes the Dex personal CRM API to AI assistants like Cursor, Claude Desktop, VS Code Copilot, and any MCP-compatible client.

Features

• 27 focused tools covering all core Dex CRM operations
• Contacts: get, create, update, delete, merge duplicates
• Groups: create, update, delete, list/add/remove members
• Tags: create, update, delete, manage tag-contact associations
• Reminders: create, update, delete
• Notes/Timeline: create, update, delete (with note type support)
• Custom Fields: list, create, update, delete
• Unified search across contacts, groups, tags, reminders, notes, and views
• User profile

Prerequisites

• Node.js >= 18
• A Dex account with an API key (Dex Professional plan required)

Setup

1. Install dependencies

npm install

2. Build

npm run build

3. Get your Dex API Key

Go to Dex Settings > API and copy your API key.

4. Configure your AI client

Cursor

Add to .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for global):

{
  "mcpServers": {
    "dex": {
      "command": "node",
      "args": ["/absolute/path/to/unnoficial-dex-mcp/dist/index.js"],
      "env": {
        "DEX_API_KEY": "dex_your_api_key_here"
      }
    }
  }
}

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "dex": {
      "command": "node",
      "args": ["/absolute/path/to/unnoficial-dex-mcp/dist/index.js"],
      "env": {
        "DEX_API_KEY": "dex_your_api_key_here"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json in your project root:

{
  "mcpServers": {
    "dex": {
      "command": "node",
      "args": ["/absolute/path/to/unnoficial-dex-mcp/dist/index.js"],
      "env": {
        "DEX_API_KEY": "dex_your_api_key_here"
      }
    }
  }
}

Development

Run the server in development mode (with hot reload via tsx):

DEX_API_KEY=dex_your_key npm run dev

Testing with MCP Inspector

The project includes a built-in inspect script that opens the MCP Inspector UI in your browser. It loads DEX_API_KEY from your .env file automatically.

npm run build
npm run inspect

This starts the inspector at http://localhost:6274 where you can browse all tools and invoke them interactively.

Note: Requires Node.js >= 18. If using nvm: nvm use 21 (or any 18+) before running.

Available Tools (27)

License

MIT