Twenty CRM MCP Server for Mastra AIGive Mastra AI instant access to 25 tools to Create Company, Create Note, Create Opportunity, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Twenty CRM through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The Twenty CRM MCP Server for Mastra AI is a standout in the Sales Automation category — giving your AI agent 25 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"twenty-crm": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Twenty CRM Agent",
instructions:
"You help users interact with Twenty CRM " +
"using 25 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Twenty CRM?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Twenty CRM MCP Server
Connect your Twenty CRM account to any AI agent and take full control of your sales pipeline and contact database through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and Twenty CRM tool infrastructure. Connect 25 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- People Management — List all contacts, fetch specific details, and create or update person records directly in the CRM.
- Company Tracking — Manage organizational accounts, list companies, and inspect company metadata using unique IDs.
- Opportunity Pipeline — Query all sales opportunities (deals), track progress, and create new entries to keep your pipeline updated.
- Full Data Control — Perform CRUD operations (Create, Read, Update, Delete) on people and companies to maintain data hygiene.
- Seamless Integration — Access your CRM data from Claude, Cursor, or any MCP-compatible client without leaving your workflow.
The Twenty CRM MCP Server exposes 25 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 25 Twenty CRM tools available for Mastra AI
When Mastra AI connects to Twenty CRM through Vinkius, your AI agent gets direct access to every tool listed below — spanning crm, contact-management, sales-pipeline, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Create company on Twenty CRM
Create a new company
Create note on Twenty CRM
Create a new note
Create opportunity on Twenty CRM
Create a new opportunity
Create person on Twenty CRM
Create a new person
Create task on Twenty CRM
Create a new task
Delete company on Twenty CRM
Delete a company
Delete note on Twenty CRM
Delete a note
Delete opportunity on Twenty CRM
Delete an opportunity
Delete person on Twenty CRM
Delete a person
Delete task on Twenty CRM
Delete a task
Get company on Twenty CRM
Get a specific company by ID
Get note on Twenty CRM
Get a specific note by ID
Get opportunity on Twenty CRM
Get a specific opportunity by ID
Get person on Twenty CRM
Get a specific person by ID
Get task on Twenty CRM
Get a specific task by ID
List companies on Twenty CRM
List companies in Twenty CRM
List notes on Twenty CRM
List notes in Twenty CRM
List opportunities on Twenty CRM
List opportunities in Twenty CRM
List people on Twenty CRM
List people in Twenty CRM
List tasks on Twenty CRM
List tasks in Twenty CRM
Update company on Twenty CRM
Update an existing company
Update note on Twenty CRM
Update an existing note
Update opportunity on Twenty CRM
Update an existing opportunity
Update person on Twenty CRM
Update an existing person
Update task on Twenty CRM
Update an existing task
Connect Twenty CRM to Mastra AI via MCP
Follow these steps to wire Twenty CRM into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the Twenty CRM MCP Server
Mastra AI provides unique advantages when paired with Twenty CRM through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Twenty CRM without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Twenty CRM tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Twenty CRM + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Twenty CRM MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Twenty CRM, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Twenty CRM as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Twenty CRM on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Twenty CRM tools alongside other MCP servers
Example Prompts for Twenty CRM in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Twenty CRM immediately.
"List all people in my Twenty CRM."
"Create a new company named 'Global Tech Solutions'."
"Get the details for opportunity ID 101."
Troubleshooting Twenty CRM MCP Server with Mastra AI
Common issues when connecting Twenty CRM to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpTwenty CRM + Mastra AI FAQ
Common questions about integrating Twenty CRM MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
SEC EDGAR Filings — 10-K, 10-Q, 8-K, Insider Trades & Full-Text Search
6 toolsAccess all SEC filings: 10-K annual reports, 10-Q quarterly reports, 8-K material event disclosures, Form 4 insider trading data, and full-text search across every document ever filed on EDGAR. Filter by company, form type, and date range.
URL Slug Generator
1 toolsTransliterate complex international text into 100% SEO-friendly URL slugs. Prevent AI hallucination of invalid characters in CMS routing.
ChargeOver
8 toolsManage recurring billing and invoicing via ChargeOver — track customers, monitor subscriptions, and analyze transactions directly from any AI agent.
Podbean Podcast Hosting
8 toolsManage your podcasts via Podbean — list episodes, publish new content, and track download analytics directly via AI.