Enables AI assistants to seamlessly interact with your Twenty CRM data through its API.
A standalone MCP (Model Context Protocol) server that integrates with Twenty CRM to provide AI-powered customer relationship management capabilities.
This server enables seamless AI interaction with Twenty CRM through the Model Context Protocol, allowing AI assistants to perform CRM operations, analyze data, and provide intelligent insights.
git clone <repository-url>
cd twenty-mcp-server
npm install
# Smart start (only starts what's needed)
npm run twenty:quick
Create workspace:
Configure MCP server:
# Setup environment file
npm run twenty:setup
# Edit .env file with your API key
# Test API discovery
npm run discover
# Start MCP server
npm run dev
The setup script creates an .env
file with:
TWENTY_API_URL
: Local Twenty instance (http://localhost:3000)TWENTY_API_KEY
: Your Twenty API keySee .env.example
for all configuration options.
npm run dev
- Start MCP server in development modenpm run build
- Build the TypeScript projectnpm run test
- Run testsnpm run lint
- Run lintingnpm run discover
- Run API discovery tool (requires Twenty CRM)npm run twenty:quick
- Smart start Twenty CRM (recommended)npm run twenty:status
- Check Twenty statusnpm run twenty:setup
- Configure MCP environmentnpm run twenty:logs
- View Twenty logsnpm run twenty:stop
- Stop Twenty servicessrc/
�� server.ts # Main MCP server entry point
�� twenty-client/ # Twenty CRM API client
�� tools/ # MCP tools implementation
�� types/ # TypeScript type definitions
�� utils/ # Utilities and configuration
Build and run with Docker:
docker build -t twenty-mcp-server .
docker run -d --env-file .env -p 3001:3001 twenty-mcp-server
docker-compose up -d
MIT License - see LICENSE file for details.
npm run discover
npm run twenty:logs
npm run twenty:status
npm run twenty:start
(resets everything)npm run twenty:help
For support and documentation, see the documentation links above or open an issue on GitHub.
Interact with data in Attio, the AI-native CRM, enabling AI assistants to access and manage your customer relationship information.
Connect with 10,000+ tools across HRIS, ATS, CRM, Accounting, Calendar, Meeting, Ticketing, and more categories.
Mercado Pago's official MCP server, offering tools to interact with our API, simplifying tasks and product integration.
A server that enables access to Joplin notes and to-dos through the Model Context Protocol (MCP).
Create Garmin Connect workouts using natural language.
Shipment tracking api and logistics management capabilities through the TrackMage API
A CalDAV MCP server to expose calendar operations as tools for AI assistants.
Guides problem-solving by breaking down complex problems and recommending the best MCP tools for each step.
Interact with your Obsidian vault from your IDE or Claude Desktop.
A comprehensive toolkit for text processing, formatting, and analysis.