skills.rest
twentyhq
twentyhqOFFICIAL
Explore all skills by this author →
WebsiteGitHub

use-twenty-mcp

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

56.0k|8.9k|Updated Dec 1, 2022
Search Tags:#mcp#workspace#CRM#twenty#CODEX#Markdown formatting#record retrieval
One-click install
npx skills add https://github.com/twentyhq/twenty --skill use-twenty-mcp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: use-twenty-mcp
Source: https://github.com/twentyhq/twenty/tree/main/packages/twenty-codex-plugin/skills/use-twenty-mcp
Command: npx skills add https://github.com/twentyhq/twenty --skill use-twenty-mcp

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 API output into readable, linked records requires manual MCP configuration and formatting rules. This Skill handles workspace connection setup, record retrieval, and consistent Markdown presentation of CRM data.

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 companies in your Twenty workspace, and receive a compact Markdown table where each company name links directly back to its record in Twenty.

Quick Start

Use $use-twenty-mcp to connect Codex to my Twenty workspace and list all my companies with links to each record.

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?▼

Use the use-twenty-mcp skill, which configures an MCP server pointing at your Twenty workspace URL. The setup reference covers workspace URL normalization, MCP server configuration, and OAuth guardrails for authentication.

How do I query Twenty CRM records from an AI agent?▼

Once the Twenty MCP server is configured, ask the agent to list or search records such as companies, people, or opportunities. Results are returned as readable 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 ask to customize via MCP.

Why are record links missing from my Twenty query results?▼

Record links require both recordReferences in the tool output and a known workspace origin. 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 read, inspect, or summarize data from an already running workspace. Use create-app or develop-app skills when you want to scaffold a new app or add objects, fields, logic, or layouts.

Related Skills

Explore More Software Engineering Skills→
Thunder-ComputeThunder-Compute
3

Thunder Compute

Create and manage Thunder Compute cloud GPU instances with SSH and port forwarding.

Official
Advanced
aura-farmingaura-farming
3

qbr-builder

Construct QBR narratives from CRM data with an evidence-first approach.

Community
Intermediate
igot-aiigot-ai

object-get-data

Retrieve serialized data of a specified Unity Object via objectRef JSON.

Official
Intermediate
rustamsrustams

Bitrix24 MCP server

Discover Bitrix24 REST API methods, parameters, and examples via MCP server.

Community
Basic