Twenty integration overview
Twenty integration overview
Section titled “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.
What you can do with it
Section titled “What you can do with it”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.
Who it is for
Section titled “Who it is for”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.
Where to go next
Section titled “Where to go next”- New here? Start with the quick start — it walks you through the whole setup without leaving the page.
- Already connected? See Use it for day-to-day usage.
- Need the permissions and trust model? See Settings & permissions.
- Hitting a problem? See Troubleshooting.
Docs content licensed under CC-BY-4.0; embedded code snippets under Apache-2.0.