一个模型上下文协议（MCP）服务器，提供与 Twenty CRM API 的无缝集成，使 LLM 代理能够通过定义清晰的类型工具与您的 CRM 数据交互。

📋 目录

• 概述
• 先决条件
• 快速入门
• 安装
• 配置
• OAuth 认证
• 验证
• IDE集成
• 使用情况
• 故障排除
• 附加资源

概述

该MCP服务器将您的Twenty CRM实例转变为一个强大的工具，供Claude及其他兼容MCP的AI助手访问。它提供对联系人、公司、任务和笔记的全面访问，支持完整的TypeScript和强大的错误处理。

主要特色

• ** 🤝 联系人管理**：创建、检索、更新和搜索联系人
• ** 🏢 公司管理**：完整的公司生命周期管理
• ** 💼 机会追踪**：完整的销售管道管理
• ** 📝 活动管理**：带过滤功能的统一时间线视图
• ** ✅ 任务管理**：创建和管理任务
• ** 🔗 关系管理**：连接实体并分析连接
• ** 🔍 元数据发现**：探索CRM模式和字段定义
• ** 🔐 OAuth 2。

Twenty MCP Server

A Model Context Protocol (MCP) server that provides seamless integration with the Twenty CRM API, enabling LLM agents to interact with your CRM data through well-defined, typed tools.

📋 Table of Contents

• Overview
• Prerequisites
• Quick Start
• Installation
• Configuration
• OAuth Authentication
• Verification
• IDE Integration
• Usage
• Troubleshooting
• Additional Resources

Overview

This MCP server transforms your Twenty CRM instance into a powerful tool accessible by Claude and other MCP-compatible AI assistants. It provides comprehensive access to contacts, companies, tasks, and notes with full TypeScript support and robust error handling.

Key Features

• 🤝 Contact Management: Create, retrieve, update, and search contacts
• 🏢 Company Management: Full company lifecycle management
• 💼 Opportunity Tracking: Complete sales pipeline management
• 📝 Activity Management: Unified timeline view with filtering
• ✅ Task Management: Create and manage tasks
• 🔗 Relationship Management: Link entities and analyze connections
• 🔍 Metadata Discovery: Explore CRM schema and field definitions
• 🔐 OAuth 2.1 Authentication: Secure user-specific API key management
• 🔒 Full TypeScript Support: Type-safe operations with validation

Total: 29 MCP Tools providing comprehensive CRM automation capabilities. See full tool list →

Understanding MCP Servers

MCP (Model Context Protocol) servers are tools that extend AI assistants like Claude with new capabilities. Once configured, this server allows Claude to:

• 🔍 Read your CRM data (contacts, companies, opportunities)
• ✍️ Create new records directly from conversations
• 🔄 Update existing information
• 🤖 Automate CRM workflows through natural language

Think of it as giving Claude direct access to your Twenty CRM, turning it into a powerful CRM assistant.

Prerequisites

Before installing, ensure you have:

• ✅ Node.js 18 or higher - Download from nodejs.org
• ✅ npm (included with Node.js)
• ✅ Git for cloning the repository
• ✅ Twenty CRM instance with API access
• ✅ Text editor for configuration files

Checking Prerequisites

# Check Node.js version (should be 18+)
node --version

# Check npm is installed
npm --version