mhenry3164/twenty-crm-mcp-server

Преобразуйте свою CRM-систему в помощника на базе искусственного интеллекта

Сервер Model Context Protocol, который соединяет Twenty CRM с Claude и другими AI-ассистентами, обеспечивая взаимодействие на естественном языке с данными ваших клиентов.

🚀 Быстрый старт • 🛠️ Инструменты • 🔍 Поиск и фильтрация • 🐳 Docker • 🤝 Вклад

---

✨ Особенности

• Полный CRUD для людей, компаний, возможностей, заметок и задач
• Рабочий поиск — построен на реальной грамматике Twenty filter (ilike совпадении), а не на несуществующем параметре search
• Корректное отображение составных полей — плоские входы, такие как firstName/email/amount, преобразуются в составные формы Twenty name/emails/amount на записи
• Пагинация курсора (startingAfter/endingBefore) плюс сырой filter, [orderBy и depth проход на каждом инструменте списка
• Заметки и задачи прикрепляются к записям — пропускают personId/companyId/opportunityId при создании, и целевые ссылки создаются для вас
• Пакетное создание — до 60 человек или компаний на один вызов
• Устойчивый клиент — тайм-ауты за 30 секунд, автоматическая повторная попытка с отключением на 429/5xx (honors Retry-After), структурированные сообщения об ошибках

---

✨ Features

• Complete CRUD for people, companies, opportunities, notes and tasks
• Working search — built on Twenty’s real filter grammar (ilike matching), not the nonexistent search param
• Correct composite-field mapping — flat inputs like firstName/email/amount are converted to Twenty’s name/emails/amount composite shapes on write
• Cursor pagination (startingAfter/endingBefore) plus raw filter, orderBy and depth passthrough on every list tool
• Notes & tasks attach to records — pass personId/companyId/opportunityId when creating and the target links are created for you
• Batch creates — up to 60 people or companies per call
• Resilient client — 30s timeouts, automatic retry with backoff on 429/5xx (honors Retry-After), structured error messages
• Schema discovery — metadata tools expose your workspace’s objects, fields and enum options, including custom objects

🚀 Installation

Prerequisites

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

Setup

1. Get your Twenty CRM API key: in Twenty, go to Settings → API & Webhooks (under Developers) and generate a key.

2. Configure your MCP client.

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "twenty-crm": {
      "command": "npx",
      "args": ["-y", "github:mhenry3164/twenty-crm-mcp-server"],
      "env": {
        "TWENTY_API_KEY": "your_api_key_here",
        "TWENTY_BASE_URL": "https://api.twenty.com"
      }
    }
  }
}

Claude Code:

claude mcp add twenty-crm -e TWENTY_API_KEY=your_api_key_here -e TWENTY_BASE_URL=https://api.twenty.com -- npx -y github:mhenry3164/twenty-crm-mcp-server

Or clone and run from source:

git clone https://github.com/mhenry3164/twenty-crm-mcp-server.git
cd twenty-crm-mcp-server
npm install