Skip to content

Twenty integration overview

The Twenty integration connects Cinatra to Twenty, the open source CRM, so your Cinatra agents can read and write the records in your Twenty workspace — People, Companies, Opportunities, and your custom objects — against the CRM that is already your system of record. Instead of asking your team to copy data into Cinatra, the integration lets agents work directly inside the CRM you already run.

It is a first-party integration: built, supported, and shipped by the Cinatra team as a marketplace extension. Under the hood it registers itself as the twenty provider behind Cinatra’s provider-agnostic CRM facade, so any Cinatra workflow that performs a CRM action routes to your Twenty workspace without naming Twenty directly. The connector talks to Twenty over Twenty’s MCP execute_tool protocol, resolving your workspace and its access token from Cinatra’s external connection registry at call time.

Once connected, your agents and workflows can:

  • Find and read records — look up People and Companies, fetch a single record, and search across your workspace.
  • Create and update records — add or edit People, Companies, and Opportunities, including values for your custom fields.
  • Work with Lists — back a Cinatra List with a Twenty View: search, get, create, and add or remove members.
  • Run against multiple workspaces — connect more than one Twenty instance and target each independently.

This integration is for teams who run a self-hosted Twenty workspace and want Cinatra agents to operate against it as the CRM of record. You connect your own Twenty instance; Cinatra does not host Twenty for you.

Docs content licensed under CC-BY-4.0; embedded code snippets under Apache-2.0.