use-twenty-mcp

Connect Codex to a Twenty workspace via MCP and format retrieved CRM records as readable Markdown.

Updated Aug 3, 2026
One-click install
npx skills add https://github.com/masoodtalha/twenty --skill use-twenty-mcp-masoodtalha
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: use-twenty-mcp
Source: https://github.com/masoodtalha/twenty/tree/main/packages/twenty-codex-plugin/skills/use-twenty-mcp
Command: npx skills add https://github.com/masoodtalha/twenty --skill use-twenty-mcp-masoodtalha

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes references (resource) components.

What problem does it solve? Connecting an AI agent to a live Twenty CRM workspace and turning raw MCP API output into readable, linked Markdown records is tedious and error-prone. This Skill handles workspace connection setup, record retrieval, and consistent formatting of dates, values, and record links. ## Core Features & Use Cases - MCP Workspace Connection: Configure Codex to connect to an existing Twenty workspace through MCP, including URL normalization, OAuth guardrails, and setup troubleshooting. - Record and Metadata Retrieval: Query and inspect workspace records, objects, fields, schema, and configuration from a running Twenty instance. - Readable Output Formatting: Present CRM data as Markdown with formatted dates, values, compact tables, and record links built as {workspaceOrigin}/object/{objectNameSingular}/{recordId}. - Use Case: Ask the agent to "list all my companies in Twenty" and receive a compact Markdown table where each company name links directly back to its record in your workspace. ## Quick Start Connect Codex to my Twenty workspace at myworkspace.twenty.com and show me all opportunities created this week as a linked Markdown table.

Frequently Asked Questions about use-twenty-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect Codex to my Twenty workspace using MCP?โ–ผ

Use this Skill to configure an MCP server pointing at your Twenty workspace URL. It normalizes the workspace URL, applies OAuth guardrails, and includes setup troubleshooting guidance from its setup reference.

How do I list records from my Twenty CRM in Markdown?โ–ผ

Ask the agent to list companies, people, or opportunities, and the Skill queries the workspace through Twenty MCP. Results are returned as compact Markdown tables with formatted dates, values, and links back to each record.

Can I use Twenty MCP to create or modify workspace objects?โ–ผ

MCP is intended for reading and inspecting workspace data, not as the default customization path. The Skill directs you to create or modify objects through a Twenty app instead, unless you explicitly request changes through MCP.

Why are record names in my results not linked to Twenty?โ–ผ

Record links require the workspace origin and recordReferences from the tool output. If the origin cannot be resolved from the MCP server URL, the Skill states that the workspace URL is needed rather than inventing a host.

When should I use Twenty MCP instead of building a Twenty app?โ–ผ

Use Twenty MCP when you want to connect to an already running workspace to retrieve, inspect, or summarize data. Use app scaffolding or development skills when you want to create or modify objects, fields, logic, or layouts.