MMCPMarkets
MT

mhenry3164/twenty-crm-mcp-server

Developer tools
72 stars 0 forks 品質 99 トレンド 99
Repository Install

A Model Context Protocol server that connects Twenty CRM with Claude and other AI assistants, enabling natural language interactions with your customer data.

概要

A Model Context Protocol server that connects Twenty CRM with Claude and other AI assistants, enabling natural language interactions with your customer data.

README

✨ Features

🚀 Installation

Prerequisites

  • Node.js 18 or higher
  • A Twenty CRM instance (cloud or self-hosted)
  • Claude Desktop or compatible MCP client

Setup

  1. Clone the repository:
git clone https://github.com/mhenry3164/twenty-crm-mcp-server.git
cd twenty-crm-mcp-server
  1. Install dependencies:
npm install

  1. Get your Twenty CRM API key:

    • Log in to your Twenty CRM workspace
    • Navigate to Settings → API & Webhooks (under Developers)
    • Generate a new API key

  2. Configure Claude Desktop:

Add the server to your claude_desktop_config.json:

{
  "mcpServers": {
    "twenty-crm": {
      "command": "node",
      "args": ["/path/to/twenty-crm-mcp-server/index.js"],
      "env": {
        "TWENTY_API_KEY": "your_api_key_here",
        "TWENTY_BASE_URL": "https://api.twenty.com"
      }
    }
  }
}

For self-hosted Twenty instances, change TWENTY_BASE_URL to your domain.

  1. Restart Claude Desktop to load the new server.

💬 Usage

Once configured, you can use natural language to interact with your Twenty CRM:

👥 People Management

"List the first 10 people in my CRM"
"Create a new person named John Doe with email [email protected]"
"Update Sarah's job title to Senior Developer"
"Find all people working at tech companies"

🏢 Company Management

"Show me all companies with more than 100 employees"
"Create a company called Tech Solutions with domain techsolutions.com"
"Update Acme Corp's annual revenue to $5M"

✅ Task Management

"Create a task to follow up with John next Friday"
"Show me all overdue tasks"
"Mark the task 'Call client' as completed"

📝 Notes & Search

"Add a note about my meeting with the client today"
"Search for any records mentioning 'blockchain'"
"Find all contacts without LinkedIn profiles"

🛠️ API Reference

The server provides the following tools:

⚙️ Configuration

Environment Variables

  • TWENTY_API_KEY (required): Your Twenty CRM API key
  • TWENTY_BASE_URL (optional): Twenty CRM base URL (defaults to https://api.twenty.com)

Custom Fields

The server automatically discovers and supports custom fields in your Twenty CRM instance. No configuration changes needed when you add new fields.

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Development

  1. Clone the repo:
git clone https://github.com/mhenry3164/twenty-crm-mcp-server.git
cd twenty-crm-mcp-server
  1. Install dependencies:
npm install
  1. Set up environment variables:
cp .env.example .env
# Edit .env with your API key
  1. Test the server:
npm test

🐛 Troubleshooting

Common Issues

Authentication Error: Verify your API key is correct and has appropriate permissions.

Connection Failed: Check that your TWENTY_BASE_URL is correct (especially for self-hosted instances).

Field Not Found: The server automatically discovers fields. If you’re getting field errors, try getting the metadata first: “Show me the available fields for people”

📄 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

  • Twenty CRM for providing an excellent open-source CRM
  • Anthropic for the Model Context Protocol
  • The MCP community for inspiration and examples

🔗 Links

View this README on GitHub

インストール

This server does not publish a one-line install command.

Open the repository installation guide

設定

{ "mcpServers": { "twenty-crm": { "command": "node", "args": ["/path/to/twenty-crm-mcp-server/index.js"], "env": { "TWENTY_API_KEY": "your_api_key_here", "TWENTY_BASE_URL": "https://api.twenty.com" } } } }