# Relaticle — MCP server card for AI agents

Open-source CRM your AI agents can write to: companies, people, opportunities, tasks and notes.

Registry name: `com.relaticle/crm` · category: Productivity and workspace · version 3.12.0 · updated 2026-11-21

## Connect
- Remote (Claude Code): `claude mcp add --transport http relaticle https://mcp.relaticle.com`

## Facts
- Repository: https://github.com/relaticle/relaticle (1,850 stars)
- Website: https://relaticle.com

Before you connect a server: read its repository, and give it only the permissions and keys it needs.

## Links
- AgentGid page: https://agentgid.com/mcp/servers/com-relaticle-crm/


## Relaticle: let your AI assistant work in your CRM

Relaticle is an open-source CRM, a place to keep the companies, people, deals, tasks and notes of your sales work. Its MCP server lets an assistant like Claude or ChatGPT read and change those records from a chat. It can also draft and send email from your connected mailbox when you allow it.

### Where to use it
- Log a call while you talk: After a call, tell your assistant what happened. It adds the person, the company, a note and a follow-up task without you opening the CRM.
- A quick look at your pipeline: Ask how many deals sit in each stage and what they add up to, or which tasks are due today. The answer comes from your own records.
- Find deals that went quiet: List the deals with no activity for a month, so you know whom to chase this week.
- Follow-up emails you check first: The assistant writes a draft in your own mailbox and stops there. You read it in Relaticle and send it yourself, or ask the assistant to send that draft.
- Developer tools with a personal token: Editors such as Cursor or VS Code connect with a personal access token instead of a browser sign-in. The token is tied to one workspace.
- Attach a contract or a slide deck: Give the assistant a file, such as a signed contract, and it stores it in the workspace and puts it into a note about the deal.

### How to start
- In Claude Code, add the hosted server and sign in; you choose one workspace on Relaticle's consent screen. ChatGPT and Claude on the web add it as a connector with the same address.

```
claude mcp add relaticle --transport http https://mcp.relaticle.com
claude mcp login relaticle
```

- For a client without browser sign-in, create a personal access token (avatar, Access Tokens, Create) and pass it from an environment variable, not typed into the command.

```
claude mcp add relaticle \
  --transport http \
  https://mcp.relaticle.com \
  --header 'Authorization: Bearer ${RELATICLE_TOKEN}'
```

- On your own server the address is your host followed by /mcp.

### License
The CRM is open source under the AGPL-3.0 and free to run on your own server. The hosted version is paid per workspace after a 14-day trial. Your own tools that only talk to it through its connection points may use any license.

### Good to know
- Changes made by the assistant are saved at once. The only check before a write is your assistant's own confirmation prompt, so keep those prompts on.
- Emails sent by the assistant reach real people outside your team. Each one waits a few minutes first, and you can cancel it from your notifications or the outbox.
- Each connection works with one workspace, chosen when you sign in. To switch, remove the connection and connect again.
- The hosted service pauses when the trial ends without a payment method; a paused workspace cannot be connected.
- Requests are limited to 120 a minute per user, and file uploads to 60 an hour per workspace.

Checked 2026-11-10 against: https://github.com/relaticle/relaticle/blob/f4965509f570efe0ddf78f0a55ddee633fc38264/README.md, https://github.com/relaticle/relaticle/blob/f4965509f570efe0ddf78f0a55ddee633fc38264/packages/Documentation/resources/content/docs/guides/mcp.md, https://github.com/relaticle/relaticle/blob/f4965509f570efe0ddf78f0a55ddee633fc38264/server.json, https://github.com/relaticle/relaticle/blob/f4965509f570efe0ddf78f0a55ddee633fc38264/routes/ai.php, https://github.com/relaticle/relaticle/blob/f4965509f570efe0ddf78f0a55ddee633fc38264/app/Mcp/Servers/RelaticleServer.php, https://github.com/relaticle/relaticle/blob/f4965509f570efe0ddf78f0a55ddee633fc38264/app/Mcp/Tools/Email/SendEmailTool.php, https://github.com/relaticle/relaticle/blob/f4965509f570efe0ddf78f0a55ddee633fc38264/app/Mcp/Tools/UploadFileTool.php, https://github.com/relaticle/relaticle/blob/f4965509f570efe0ddf78f0a55ddee633fc38264/INTEGRATION-EXCEPTION.md, https://github.com/relaticle/relaticle/blob/f4965509f570efe0ddf78f0a55ddee633fc38264/.github/TRADEMARK.md, https://github.com/relaticle/relaticle/blob/f4965509f570efe0ddf78f0a55ddee633fc38264/LICENSE, https://github.com/relaticle/relaticle/releases.atom, https://relaticle.com/pricing, https://relaticle.com/developers/mcp

### Mistakes to avoid
- Don't: filter {"stage": "Won"} or {"custom_fields": {"stage": {"eq": "Won"}}} → Do: {"custom_fields": {"stage": {"$eq": "Won"}}}: custom fields sit under custom_fields and every operator starts with $ (There is no shorthand in the filter language; both forms return an error.)
- Don't: old flat filter keys such as company_id, search or created_after → Do: {"company": {"$in": ["<company id>"]}} for links; the search tool for words across all records (The earlier flat filter names were removed and now return an error naming the replacement.)
- Don't: writing custom_fields from guessed field codes → Do: call get-crm-schema-tool for the record type first and use its field codes and choice labels (Custom fields differ per workspace, and resources are not shown by every client.)
- Don't: send-email-tool when the person wants to read the email first → Do: create-email-draft-tool, then send-email-draft-tool only after the person says so (A sent email reaches people outside the workspace; the tool itself says to prefer a draft for review.)
- Don't: --header 'Authorization: Bearer <token typed in>', or the same with --scope project → Do: --header 'Authorization: Bearer ${RELATICLE_TOKEN}' with the token in the environment (A typed token is stored in plain text, and with project scope it lands in .mcp.json shared through version control.)

### Questions
- Does the assistant need my password or a key? Claude, Claude Code and ChatGPT sign in through Relaticle's consent screen in the browser. Other clients use a personal access token you create in Relaticle.
- Can the assistant send email without me? Only if the connection was given send access. Each email is held a few minutes and you can cancel it; drafts are never sent on their own.
- Is a deleted record gone for good? No. The delete tools for companies, people, deals, tasks and notes are soft deletes.
- How do I cut off an assistant? Settings, Access Tokens, AI Connectors lists every connected assistant with a Revoke button; revoking stops it at once and its unsent emails are not sent.
- Do the assistant's requests use up the plan's AI credits? No. The credits are for Relaticle's own built-in assistant; calls from your assistant over the MCP server do not use them.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
