
Relaticle CRM MCP Server: Setup for Claude, ChatGPT and Other Apps
Lets Claude, ChatGPT and other assistants read and update your Relaticle CRM: companies, people, deals, tasks, notes and email drafts.
Relaticle is an open-source CRM, and its own server lets an assistant search, read, create, update and delete your companies, people, deals, tasks and notes, and draft or send email. Use the hosted version at the address in the install box and sign in, or run your own copy of Relaticle. Each connection works in one workspace only. The email tools can send real mail and the delete tools remove records, so review what the assistant plans before you let it act.
Good for
- Sales teams who want an assistant to log notes and update deals
- Founders who want pipeline answers without opening the CRM
- Teams who self-host a CRM and want their own data kept in house
- Anyone drafting follow-up emails from CRM context
Works in
14 should work
Tap an app to see how to set it up and any known problems.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Install Relaticle CRM MCP
Claude Code
- 1
Copy this prompt.
Add the Relaticle CRM MCP server to Claude Code. Run this command: claude mcp add --transport http relaticle-crm https://mcp.relaticle.com Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Sign-in with the vendor account (OAuth).
Built from the package data we hold. Not yet tested by us.
Tools
Finds companies, people, deals, tasks and notes by keyword
Searches names, titles and searchable custom fields across all five record types and returns a link to each match.
Try: “Find anything about Acme in the CRM.”
Read ·
searchOpens one CRM record from its link
Returns a single record when you give the link from a search result or copied from the browser.
Try: “Open this record: the Acme deal link.”
Read ·
fetchShows record counts, pipeline totals and task due status
Gives workspace counts, deal totals by stage, and which tasks are due, using your time zone.
Try: “Give me a summary of my CRM.”
Read ·
get-crm-summary-toolTotals deals and pipeline value by stage or company
Counts opportunities and sums their amount grouped by stage or company, with optional creation dates.
Try: “What is my pipeline value by stage this quarter?”
Read ·
aggregate-opportunities-toolShows recent changes made in the workspace
Lists who changed what over the last 1 to 30 days, for the whole workspace or one record.
Try: “What changed on the Acme record this week?”
Read ·
list-activity-toolShows who you are signed in as and what you may do
Returns your user, workspace, role, workspace members and the abilities this connection holds.
Try: “Which workspace am I connected to and what can I do?”
Read ·
who-ami-toolLists companies, with filters
Returns companies from the CRM with optional filters and paging.
Try: “List companies in the software industry.”
Read ·
list-companies-toolShows one company
Returns a single company with its fields and optional related records.
Try: “Show me the Acme company record.”
Read ·
get-company-toolAdds a company
Creates a company and fills in its standard and custom fields.
Try: “Add Globex as a new company with website globex.com.”
Write ·
create-company-toolEdits a company
Changes fields on an existing company.
Try: “Update Acme's employee count to 250.”
Write ·
update-company-toolDeletes a company (soft delete)
Removes a company from the CRM. It is a soft delete, so the docs say a deleted record can be restored.
Try: “Delete the duplicate Globex company.”
Delete ·
delete-company-toolLists contacts, with filters
Returns people from the CRM with optional filters and paging.
Try: “List contacts at Acme.”
Read ·
list-people-toolShows one contact
Returns a single person with their fields and related records.
Try: “Show me Jane Doe.”
Read ·
get-people-toolAdds a contact
Creates a person, optionally linked to a company.
Try: “Add Jane Doe, CTO at Acme.”
Write ·
create-people-toolEdits a contact
Changes fields on an existing person.
Try: “Change Jane's title to CEO.”
Write ·
update-people-toolDeletes a contact (soft delete)
Removes a person from the CRM as a soft delete.
Try: “Delete the duplicate Jane Doe contact.”
Delete ·
delete-people-toolLists deals, with filters
Returns opportunities with optional filters and paging.
Try: “List open deals over 10,000.”
Read ·
list-opportunities-toolShows one deal
Returns a single opportunity with its stage, amount and related records.
Try: “Show the Acme renewal deal.”
Read ·
get-opportunity-toolAdds a deal
Creates an opportunity with its stage and amount.
Try: “Create a 20,000 deal for Acme in the proposal stage.”
Write ·
create-opportunity-toolEdits a deal
Changes stage, amount or other fields on an opportunity.
Try: “Move the Acme deal to closed won.”
Write ·
update-opportunity-toolDeletes a deal (soft delete)
Removes an opportunity from the CRM as a soft delete.
Try: “Delete the test deal.”
Delete ·
delete-opportunity-toolLists tasks, with filters
Returns tasks with optional filters and paging.
Try: “Which tasks are overdue?”
Read ·
list-tasks-toolShows one task
Returns a single task and its related records.
Try: “Show the follow-up task for Acme.”
Read ·
get-task-toolAdds a task
Creates a task and fills in its fields.
Try: “Create a task to call Jane on Friday.”
Write ·
create-task-toolEdits a task
Changes fields on a task, such as due date or status.
Try: “Mark the call task as done.”
Write ·
update-task-toolDeletes a task
Removes a task from the CRM.
Try: “Delete the old follow-up task.”
Delete ·
delete-task-toolLinks a task to companies, people or deals
Attaches an existing task to one or more records.
Try: “Link this task to Acme and Jane Doe.”
Write ·
attach-task-to-entities-toolUnlinks a task from records
Removes the link between a task and the records you name. The task itself stays.
Try: “Unlink this task from Globex.”
Write ·
detach-task-from-entities-toolLists notes, with filters
Returns notes with optional filters and paging.
Try: “Show notes from this month.”
Read ·
list-notes-toolShows one note
Returns a single note and its related records.
Try: “Show the kickoff meeting note.”
Read ·
get-note-toolAdds a note
Creates a note and fills in its fields.
Try: “Add a note about today's call with Acme.”
Write ·
create-note-toolEdits a note
Changes the content or fields of a note.
Try: “Add the budget figure to the kickoff note.”
Write ·
update-note-toolDeletes a note
Removes a note from the CRM.
Try: “Delete the scratch note.”
Delete ·
delete-note-toolLinks a note to records
Attaches an existing note to one or more records.
Try: “Attach this note to the Acme deal.”
Write ·
attach-note-to-entities-toolUnlinks a note from records
Removes the link between a note and the records you name. The note stays.
Try: “Detach this note from Globex.”
Write ·
detach-note-from-entities-toolStores a file in the workspace
Saves a file from a public https link, base64 text, or an earlier upload, and returns markdown to embed it in a note or task.
Try: “Attach this contract PDF to the Acme note.”
Write ·
upload-fileLists emails you can see
Shows synced and sent mail plus your drafts and outbox, newest first, with the access level you have to each.
Try: “Show the latest emails from Jane.”
Read ·
list-emails-toolOpens one email
Returns a single email, with as much detail as your access level allows.
Try: “Show me that email from Jane in full.”
Read ·
get-email-toolSaves an email draft
Saves a draft in one of your mailboxes. Nothing is sent: you review and send it from Drafts in Relaticle.
Try: “Draft a follow-up email to Jane.”
Write ·
create-email-draft-toolEdits a draft
Changes the recipients, subject or body of a saved draft.
Try: “Make the draft shorter.”
Write ·
update-email-draft-toolDeletes a draft
Removes a saved draft.
Try: “Delete that draft.”
Delete ·
delete-email-draft-toolSends an email from your mailbox
Sends to people outside the workspace. It is held for a few minutes first, and you can cancel it from your notifications or Outbox.
Try: “Email Jane that the proposal is attached.”
Write ·
send-email-toolSends a saved draft
Sends a draft as it stands, including your edits made in Relaticle. It is held for a few minutes first.
Try: “Send the draft to Jane.”
Write ·
send-email-draft-toolCancels a queued email
Stops an email that is still queued so it is never sent. It is too late once sending has started.
Try: “Cancel the email to Jane.”
Write ·
cancel-email-toolChanges when a queued email is sent
Moves the send time of a queued email.
Try: “Send that email tomorrow at 9.”
Write ·
reschedule-email-toolQueues a failed email again
Puts a failed email back in the queue, held for a few minutes like a new send.
Try: “Retry the failed email.”
Write ·
retry-email-toolUsed by the assistant behind the scenes
Describes the fields and options for one record type
Returns the active custom fields, choice options, filters and relationships for companies, people, opportunities, tasks or notes.
Try: “What fields can I fill in for a deal?”
Read ·
get-crm-schema-toolLists your custom field definitions
Returns custom fields for the workspace, including inactive ones and their option labels.
Try: “Which custom fields do we have on people?”
Read ·
list-custom-fields-toolGets a short-lived link for uploading a file
Returns a signed link to PUT a file to, up to 10 MB, for common document and image types. It is the first step of a large upload.
Try: “Prepare an upload for brief.pdf.”
Write ·
create-upload-urlLists your connected mailboxes
Shows the mailboxes connected to your account and whether each can send.
Try: “Which mailboxes can I send from?”
Read ·
list-email-accounts-tool
Read from the source code
Permissions
high risk · 6 things to watch
High risk
The assistant can change or delete CRM records and send email from your mailbox. Use a token with only the abilities you need and review emails before the hold ends.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It can email people outside your team
The send tools send mail from your mailbox to anyone. Mail is held a few minutes and can be cancelled, but check each message before the hold ends. github.com
It can delete CRM records
Delete tools remove companies, contacts, deals, tasks, notes and drafts. The help docs describe restoring a deleted record. github.com
It can change every record in the workspace
Create and update tools edit your CRM data. Use a token limited to the abilities you need. github.com
Notes and emails can carry prompt injection
Text written by outside people ends up in records and emails the assistant reads. Do not let it send mail or delete records without your review. github.com
File upload fetches links you give it
The upload tool can pull a public https link or base64 data into your workspace, up to the allowed types and size. github.com
One workspace per connection
Each connection is limited to the single workspace it signed in to. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only switch is documented. A personal access token can be limited to certain abilities (read, create, update, delete), but that is a token setting, not a server mode. |
|---|---|
| Talks to | mcp.relaticle.com, or your own Relaticle host. Public links you ask it to upload |
| Sign-in and keys | Sign in with OAuth 2.1, or use a personal access token. One workspace per connection. |
| Scopes |
|
Questions
Is the Relaticle MCP server official?
Yes. It ships inside the Relaticle CRM's own repository and is run by the same project at mcp.relaticle.com.
What is the Relaticle MCP server URL?
https://mcp.relaticle.com for the hosted version, or https://your-host/mcp if you self-host Relaticle.
How do I sign in?
The README says the server accepts OAuth 2.1 or a personal access token. Claude and ChatGPT connect by adding the URL and signing in to your Relaticle account.
Can it send email?
Yes. It can save drafts, and it can send mail from your connected mailbox. Sent mail is held a few minutes first, and you can cancel it from your Relaticle notifications or Outbox.
Can it delete data?
Yes. It can delete companies, people, deals, tasks, notes and drafts. The deletes for records are soft deletes, and the docs describe restoring a deleted record.
Does it work with ChatGPT?
Yes. The README says to install Relaticle from the ChatGPT plugin directory. The search and fetch tools are built for ChatGPT's company knowledge.
Is Relaticle free?
The software is open source under AGPL-3.0, and you can self-host it. The hosted service has billing plans; see Relaticle's pricing for current prices.
Can I limit what the assistant can do?
Partly. A personal access token can hold fewer abilities, such as read only. There is no server-wide read-only switch.
Information
updated Nov 2, 2026
- Publisher
- Official
- Endpoint
https://mcp.relaticle.com- Transport
- Streamable HTTP
- Auth
- OAuth
- Version
- 3.8.0
- License
- AGPL-3.0
- Last commit
- Oct 31, 2026
- Open issues
- 12
- Listed in
- Official MCP registry
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 2Hide
- github.com · github.com
- github.com · github.com