Agent skill

Twenty CRM via MCP

by twentyhq in twentyhq/twenty

Connects the agent to an existing Twenty workspace through MCP to read records and metadata, and presents CRM data as readable Markdown with links instead of raw API output.

Custom licenceAuto-check passedSales & Support

Install Twenty CRM via MCP

skills CLI
$ npx skills add twentyhq/twenty --skill use-twenty-mcp -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install twentyhq/twenty use-twenty-mcp --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/twentyhq/twenty.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/twenty-agent-skills/skills/use-twenty-mcp .claude/skills/use-twenty-mcp && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
use-twenty-mcp
GitHub stars
58k
Token cost
~775 tokens
SKILL.md length
399 words
Files
2
Skills in repo
13
Repo updated
First seen
Licence
Custom licence

At a glance

Connects the agent to an existing Twenty workspace through MCP to read records and metadata, and presents CRM data as readable Markdown with links instead of raw API output.

  • Listing companies, people or opportunities from a Twenty workspace
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Summarizing the sales pipeline held in Twenty
  • Inspecting an object's fields and schema

What it does

The skill is for reading and inspecting a running Twenty workspace, not for changing app code. Typical requests are listing companies, people or opportunities, showing records created this week, summarizing a pipeline, viewing the fields on the company object and connecting the agent to a workspace URL. Scaffolding an app, developing app entities, managing an app and preparing marketplace assets belong to other skills: create-app, develop-app, manage-app and publish-app.

Setup details, including workspace URL normalization, MCP server configuration and OAuth guardrails, live in a setup reference, and a result-formatting reference must be read before retrieving or presenting records. The output contract says that when the tool returns recordReferences, each record name links back to Twenty, with readable dates and values and compact tables in place of raw API output. MCP is not the default route for customizing a workspace; creating an object, for example, is preferred through a Twenty app unless you explicitly ask for MCP.

When your agent uses it

  • Listing companies, people or opportunities from a Twenty workspace
  • Summarizing the sales pipeline held in Twenty
  • Inspecting an object's fields and schema
  • Connecting an agent to a workspace and troubleshooting MCP access

Example prompts

  • “List all my companies in Twenty and link each one back to its record.”
  • “Summarize my pipeline from Twenty as a compact table.”
  • “Set up Twenty MCP for myworkspace.twenty.com.”
  • “Show me the fields on the company object.”

Requirements

  • A running Twenty workspace reachable through MCP

What it can do on your machine

Read from SKILL.md and the folder at commit 22ada84. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Twenty CRM via MCP loads about 775 tokens when it runs. Until then it costs about 74 tokens; SKILL.md has 399 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~74
When it runs · the whole SKILL.md, loaded when a task matches
~775

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 399 words (~775 tokens).

“Pick this skill when the user wants to read from or inspect a running Twenty workspace — not change app code. Representative triggers:”

— opening of SKILL.md by twentyhq, Custom licence
name
use-twenty-mcp

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in packages/twenty-agent-skills/skills/use-twenty-mcp of twentyhq/twenty.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 22ada84

Compare with similar skills

Twenty CRM via MCP next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Twenty CRM via MCP compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Twenty CRM via MCP this skilltwentyhq/twenty58k—~775Automated safety check: PassCustom licence
Nextcrmpdovhomilja/nextcrm-app717—~3.3kAutomated safety check: PassMIT
Platform Lsp Integrateforcedotcom/sf-skills1.1k—~3.2kAutomated safety check: NotesApache-2.0
Agentforce GenerateSalesforceAIResearch/agentforce-adlc1141 repos~7.4kAutomated safety check: PassCustom licence
LinkedIn MCP Usage Rulesstickerdaniel/linkedin-mcp-server3.8k—~651Automated safety check: PassApache-2.0
Hostinger Headless Entryhostinger/api-mcp-server160—~1.3kAutomated safety check: PassMIT

Similar skills

  • Nextcrm

    pdovhomilja/nextcrm-app

    Connect to NextCRM MCP server to manage CRM data — accounts, contacts, leads, opportunities, targets, products, contracts, activities, documents, target lists, enrichment, email accounts, campaigns…

    717 GitHub stars~3.3k tokensUpdated today
    Sales & SupportAuto-check passed
  • Platform Lsp Integrate

    forcedotcom/sf-skills

    Reference/contract for the Salesforce LSP MCP tools and unavailability handling.

    1.1k GitHub stars~3.2k tokensUpdated yesterday
    Sales & SupportAuto-check: notes
  • Agentforce Generate

    SalesforceAIResearch/agentforce-adlc

    Build, modify, audit, repair, optimize, debug, and deploy agents with Agentforce Agent Script.

    114 GitHub starsUsed in 1 repo~7.4k tokens
    Agent WorkflowsAuto-check passed
  • LinkedIn MCP Usage Rules

    stickerdaniel/linkedin-mcp-server

    Rules for using the bundled LinkedIn MCP server for profile, company, job, post, feed and inbox work, with explicit authorization required for messages and connection requests.

    3.8k GitHub stars~651 tokensUpdated today
    Sales & SupportAuto-check passed
  • Hostinger Headless Entry

    hostinger/api-mcp-server

    Build a complete website on Hostinger from a single prompt — hosting, domain, and (optionally) a store with real checkout or a blog/CMS the owner edits in WordPress.

    160 GitHub stars~1.3k tokensUpdated 2 days ago
    Sales & SupportAuto-check passed
  • Hostinger Headless

    hostinger/api-mcp-server

    Build, connect, or iterate on a website hosted on Hostinger — provision hosting and a domain, optionally seed an ecommerce store with a real hosted checkout or a WordPress content backend (headless…

    160 GitHub stars~1.8k tokensUpdated 2 days ago
    Sales & SupportAuto-check passed

More from twentyhq/twenty

All 13 skills in this repo
  • Guides changes to an existing Twenty app: adding or editing objects, layouts, logic functions and front components, with a plan stated before multi-entity edits.

    58k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Twenty App Operations

    twentyhq/twenty

    Operates an existing Twenty app: managing remotes, syncing, building, deploying, reading logs, running tests and setting up CI/CD, with confirmation for production.

    58k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Contributor guide for step three of adding a syncable entity to the Twenty server: write the validator, the migration action builder and the orchestrator wiring.

    58k GitHub stars~3.3k tokensUpdated today
    Auto-check passed
  • Walks through step 2 of adding a syncable entity to the Twenty server: a cache service for flat entity maps and utilities that transform entities and DTOs into universal flat entities.

    58k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Registers a new syncable entity in three NestJS modules and adds its service and GraphQL resolver layers when contributing to the Twenty server.

    58k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Step four of adding a syncable entity in the Twenty server: write create, update and delete action handlers that run workspace migrations against the database.

    58k GitHub stars~3.1k tokensUpdated today
    Auto-check passed

Questions about Twenty CRM via MCP

What does Twenty CRM via MCP do?

Connects the agent to an existing Twenty workspace through MCP to read records and metadata, and presents CRM data as readable Markdown with links instead of raw API output. The skill is for reading and inspecting a running Twenty workspace, not for changing app code. Typical requests are listing companies, people or opportunities, showing records created this week, summarizing a pipeline, viewing the fields on the company object and connecting the agent to a workspace URL.

When should I use Twenty CRM via MCP?

Twenty CRM via MCP fits situations like: listing companies, people or opportunities from a Twenty workspace; summarizing the sales pipeline held in Twenty; inspecting an object's fields and schema; connecting an agent to a workspace and troubleshooting MCP access.

How do I install Twenty CRM via MCP in Claude Code?

Run `npx skills add twentyhq/twenty --skill use-twenty-mcp -a claude-code`. Or copy the skill folder (packages/twenty-agent-skills/skills/use-twenty-mcp in twentyhq/twenty) into .claude/skills/use-twenty-mcp in your project. Claude Code loads it when a task matches its description.

How do I install Twenty CRM via MCP in Codex?

Run `npx skills add twentyhq/twenty --skill use-twenty-mcp -a codex`. Or copy the skill folder (packages/twenty-agent-skills/skills/use-twenty-mcp in twentyhq/twenty) into .agents/skills/use-twenty-mcp in your project. Codex loads it when a task matches its description.

Can I use Twenty CRM via MCP in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add twentyhq/twenty --skill use-twenty-mcp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/use-twenty-mcp, .gemini/skills/use-twenty-mcp, .github/skills/use-twenty-mcp and .opencode/skills/use-twenty-mcp in your project.

What does Twenty CRM via MCP need to run?

SKILL.md names no scripts, command-line tools or credentials: Twenty CRM via MCP is instructions for the agent only. Our summary lists: A running Twenty workspace reachable through MCP.

Does Twenty CRM via MCP access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Twenty CRM via MCP safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Twenty CRM via MCP use?

Twenty CRM via MCP has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Twenty CRM via MCP use?

About 775 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Twenty CRM via MCP?

Skills that share tags, products or a category with Twenty CRM via MCP: Nextcrm (pdovhomilja/nextcrm-app, 717 stars), Platform Lsp Integrate (forcedotcom/sf-skills, 1.1k stars), Agentforce Generate (SalesforceAIResearch/agentforce-adlc, 114 stars) and LinkedIn MCP Usage Rules (stickerdaniel/linkedin-mcp-server, 3.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Twenty CRM via MCP?

twentyhq (a GitHub organization) maintains it in twentyhq/twenty, which has 58,192 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on October 11, 2026.

Source: twentyhq/twenty on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.