CRM

Connector by Cinatra
Free, Open Source
Details

CRM Connector

Provider-agnostic CRM facade for Cinatra. Exposes 15 crm_* MCP tools (contacts, accounts, lists) that route to the registered CRM provider, so agents write CRM-agnostic code regardless of which CRM backend is installed.

Purpose. Agents call crm_contact_*, crm_account_*, and crm_list_* without coupling to a specific CRM. The connector normalises provider shapes into Cinatra's shared types and keeps cinatra.objects pointer rows in sync after each write.

Install. Add this connector via the marketplace. A CRM provider extension (such as Twenty CRM) must also be installed; without one, the connector returns a descriptive error on first call. No connector-level configuration is required — CRM credentials are managed by the provider extension.

Usage. The 15 crm_* tools include crm_contact_search { query }, crm_contact_create { name, email?, title?, accountId? }, crm_account_search { query }, and crm_list_search { query, objectType? }. Create and update calls write both the provider record and a cinatra.objects pointer row; failures are retried via a durable background job (up to 5 attempts, exponential backoff).

API contract. Contacts: id, name, email, title, accountId. Accounts: id, name, domainName. Lists: id, slug, name, objectType (contact | account). Shapes live in @cinatra-ai/sdk-extensions.

Development. Run pnpm install && pnpm test. Run node extension-kind-gate.mjs to validate before a pull request. Source is in src/; server entry is src/register.ts.

Troubleshooting. "No CRM provider registered" — activate a provider extension on the instance. Pointer-repair failures log to stderr as [POINTER_REPAIR_FALLBACK] JSON for manual replay.

Works with

  • Twenty CRM connector (@cinatra-ai/twenty-connector) — the only provider currently supported

Capabilities

  • Provider-agnostic verbs — agents call crm_contact_* / crm_account_* / crm_list_* regardless of CRM backend
  • Pointer-row coupling — writes update cinatra.objects pointer and the CRM provider in one handler
  • Cinatra-shaped types — provider shapes collapse to Cinatra's shared contact / account / list types at the facade
  • Durable pointer repair — failed pointer writes retried via BullMQ with exponential backoff and a structured stderr fallback
  • Provider-swap ready — the facade indirection allows adding new CRM providers without changing the agent call-sites
@cinatra-ai/competitive-analysis-artifact @cinatra-ai/default-artifact
Reviews (0)

Reviews

There are no reviews yet.

Be the first to review “CRM”

Your email address will not be published. Required fields are marked *

@cinatra-ai/competitive-analysis-artifact @cinatra-ai/default-artifact
Changelog
0.1.1Latest
  • refactor: adopt ctx.authSession + ctx.jobs host ports via a deps slot (cinatra#172 Stage H1) (#16)
  • ci(release): grant contents: write + pin reusable workflow to .github HEAD (#17)
  • ci: repin reusable release workflow (immutable-safe decoration + corrected build-input provisioning) (#18)
  • release: crm-connector v0.1.1 (republish on corrected serverEntry build pipeline) (#19)
0.1.0
  • Initial release.
  • Unreleased
  • fix(test): crm-contact-finder asserts the real extension import paths (../components/ui + @cinatra-ai/sdk-ui) (#1)
  • ci: adopt source-leak-gate (#2)
  • ci: adopt source-leak-gate (#3)
  • chore: add .gitignore (#4)
  • ci: adopt org gates — SHA-pin all remote uses: refs, bump source-leak-gate to v0.1.0, add actions-pinned + gitignore gate callers (#5)
  • chore: keep internal planning notes untracked (#6)
  • Split the chat-widget manifest into a pure-data module (widgets/manifest.ts) (#7)
  • Add package exports map for the consumed subpaths (incl. ./widgets/manifest) (#8)
  • chore: npm files allowlist + export-ignore packaging hygiene (#9)
  • ci: adopt the org ui-design-system gate (#10)
  • serverEntry register(ctx): expose the CRM integration surfaces as capabilities (cinatra#7 P721) (#11)
  • fix(tests): type the saveObject mock parameter (host tsgo strictness) (#12)
  • feat: register the crm-list-reader capability surface (cinatra#151 Stage 4) (#13)
  • chore: Configure Renovate (#14)
  • ci: add truthful-attribution-gate in WARN (advisory) mode (#20)
  • ci: adopt the reusable extension->host IoC conformance gate (org-wide rollout) (#21)
  • ci: tag-driven GitHub release on v* (#22)
  • ci: adopt secret-scan-gate (#23)
  • docs(readme): expand README to the org standard (#24) (#25)
  • ci(ui-gate): ramp raw-JSX block to error (#26)
  • ci: adopt source-leak-gate (#27)
  • ci: adopt source-leak-gate (#28)
  • ci(ui-gate): re-vendor preset with Block-C (dynamic-import ban) + bump pin to v0.1.1 (#29)
  • chore: strip private engineering-tracker refs from public source (#30)
  • chore: strip private tracker references from workflow comments (#33)
  • chore(manifest): backfill cinatra.sdkAbiRange "^2" (#34)
  • ci(release): pin reusable-extension-release to gated v0.1.1 (release-approval wall) (#35)
  • chore: add cinatra.vendor and displayName connector metadata (#36)
  • chore(deps): declare cinatra.consumes for closure-gate enrollment (#37)
@cinatra-ai/competitive-analysis-artifact @cinatra-ai/default-artifact
More Extensions

More from Cinatra

@cinatra-ai/default-artifact
Artifact by CinatraVerified publisher

The built-in fallback type that guarantees every item in the library has at least one valid classification. When a file, connector reference, or dashboard…

Free, Open Source
More details
No reviews yet 53 installations
Chart
Artifact by CinatraVerified publisher

Renders data charts in the Cinatra chat surface. Agents describe a chart as a small data spec — a type (bar, line, or area),…

Free, Open Source
More details
No reviews yet 152 installations
@cinatra-ai/drupal-skills
Skills by CinatraVerified publisher

The conversational skill behind the Cinatra chat widget that lives inside the Drupal node editor. It decides on every message whether you are asking…

Free, Open Source
More details
No reviews yet 81 installations
@cinatra-ai/slide-deck-artifact
Artifact by CinatraVerified publisher

A slide-format presentation exported to PDF — pitch decks, sales decks, conference talks, board decks, training presentations, and customer-facing decks. Slide Decks get a…

Free, Open Source
More details
No reviews yet 60 installations
@cinatra-ai/marketing-icp-artifact
Artifact by CinatraVerified publisher

An Ideal Customer Profile — the audience a company sells into, captured as buyer persona, firmographics, pain points, triggering events, disqualifiers, and buying-process notes.…

Free, Open Source
More details
No reviews yet 55 installations
Media Feeds
Connector by CinatraVerified publisher

Pull a structured episode list out of any YouTube channel or podcast website so downstream agents can pick what to transcribe, summarize, or analyse.…

Free, Open Source
More details
No reviews yet 42 installations
Compatible up to: Cinatra SDK ^2
@cinatra-ai/competitive-analysis-artifact @cinatra-ai/default-artifact