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.
Dynamically search and call tools using UnifAI Network
AI Task schedule planning with LLamaIndex and Timefold: breaks down a task description and schedules it around an existing calendar
Interact with task, doc, and project data in Dart, an AI-native project management tool
MCP server to interact with Routine: calendars, tasks, notes, etc.
Interact with the accounting data in your business using our official MCP server
A Model Context Protocol server for integrating HackMD's note-taking platform with AI assistants.
Access and manage your VISO TRUST third-party risk program directly through your AI assistant.
Programmatic control over Windows system operations including mouse, keyboard, window management, and screen capture using nut.js.
Interact with Ramp's Developer API to run analysis on your spend and gain insights leveraging LLMs
Generate high-quality text-to-speech and text-to-voice outputs using the DAISYS platform.