How to Use the Twenty CRM MCP in Mastra AI

Q: How does Mastra AI handle updating records in Twenty CRM?

Mastra AI manages updates using defined workflows. If updateperson fails due to an API issue, the system automatically retries the operation until it succeeds or hits a maximum attempt limit.

Q: Can Mastra AI manage multiple Twenty CRM actions in sequence?

Yes. You can chain calls together: first createnote, then retrieve related data with getcompany, and finally update the note using updatenote. The entire sequence is treated as one reliable, stateful operation.

Build reliable, multi-step CRM workflows with Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Twenty CRM MCP to Mastra AI

Create your Vinkius account to connect Twenty CRM to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Twenty CRM with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automating Complex Flows with the MCP Server

Mastra AI handles failure gracefully. You can set up a workflow where if an action fails—say, `update_person` times out—the system automatically retries using exponential backoff. This makes your CRM processes robust and dependable. The built-in conditional branching means you don't just run commands; the agent decides what to do next based on the result of a previous tool call.

Handling Twenty CRM Actions with Mastra AI

You can design multi-step workflows that cover the entire lifecycle. For example, first creating an `create_opportunity`, then checking if it's ready for action using `get_company` data before finally assigning a follow-up via `create_task`. The system manages the state throughout. If the final step fails (maybe `update_opportunity` hits a validation error), Mastra AI catches it, executes a custom retry logic, and notifies an admin.

Reliably Managing CRM Data with Mastra AI

The MCP Server supports structured data updates. You can write complex sequences: use `list_companies` to find all accounts matching criteria, then loop through them calling `update_company` for each one to change their status. This handles massive batch operations reliably.

Setup guide

Set up Twenty CRM MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Twenty CRM tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "twenty-crm-mcp-client",
  servers: {
    "twenty-crm-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Twenty CRM Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Twenty CRM tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Twenty CRM transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Twenty. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Twenty CRM now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Twenty CRM MCP in Mastra AI

Mastra AI manages updates using defined workflows. If `update_person` fails due to an API issue, the system automatically retries the operation until it succeeds or hits a maximum attempt limit.

Yes. You can chain calls together: first `create_note`, then retrieve related data with `get_company`, and finally update the note using `update_note`. The entire sequence is treated as one reliable, stateful operation.

It does. Mastra AI’s core strength is managing failures. It provides automatic retries with backoff and allows you to define specific failure paths, so no process stalls out.

This MCP Server touches Person, Company, Opportunity, Note, and Task records. The workflow engine treats all these fields as reliable state components.

It's built specifically for that. Its ability to manage conditional branching, automatic retries, and complex multi-step logic makes it ideal for critical business operations.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript