Lets an AI client read, write, and analyze CRM records such as companies, people, opportunities, tasks, and notes.
Also known as relaticle/relaticle
- Stars
- 1,844
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 3.10.0
- Last commit
- Nov 15, 2026
- License
- AGPL-3.0
What is Relaticle MCP?
Relaticle lets an AI client read, write, and analyze CRM records such as companies, people, opportunities, tasks, and notes.
Summary generated from the project's README
About Relaticle MCP server
Managing sales pipelines and customer data through AI agents is what Relaticle enables for individuals selling to specific company lists without a dedicated sales team. This self-hosted CRM allows users to connect clients like Claude, ChatGPT, or Cursor to interact directly with their sales records. By using the MCP server, an AI can perform full CRUD operations, meaning it can read, write, and update information across various categories.
Users can manage companies, people, opportunities, tasks, and notes using a customizable data model that supports custom fields for dates, currency, and text. The system is built on a modern stack including Laravel 13 and PHP 8.5, providing multi-workspace isolation and per-field encryption for privacy. Setup involves hosting the application via Docker or manual deployment, then connecting an agent using a personal access token or OAuth 2.1 to access specific workspace data.
What you can do with it
- 1Automate CRM data entryAsk your AI agent to create a new contact or opportunity record within your sales pipeline.
- 2Analyze sales performanceRequest a summary of your current sales pipeline and activity history to identify trends.
- 3Maintain organized customer recordsHave an AI client update specific custom fields or add notes to an existing company profile.
Written from the project's README. Every use case is checked against a quote from it.
How to install Relaticle MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Relaticle MCP in Claude Code
$ claude mcp add --transport http relaticle https://mcp.relaticle.com/Install Relaticle MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"relaticle": {
"url": "https://mcp.relaticle.com/"
}
}
}Install Relaticle MCP in VS Code
.vscode/mcp.json
{
"servers": {
"relaticle": {
"type": "http",
"url": "https://mcp.relaticle.com/"
}
}
}Install Relaticle MCP in VS Code CLI
$ code --add-mcp '{"name":"relaticle","type":"http","url":"https://mcp.relaticle.com/"}'Install Relaticle MCP in Codex
$ codex mcp add relaticle --url https://mcp.relaticle.com/Install Relaticle MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.relaticle] url = "https://mcp.relaticle.com/"
Install Relaticle MCP in Gemini CLI
$ gemini mcp add -s user --transport http relaticle https://mcp.relaticle.com/Install Relaticle MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"relaticle": {
"url": "https://mcp.relaticle.com/",
"type": "http"
}
}
}Configuration
APP_KEYAPP_URLDB_PASSWORD
| Name | Description | |
|---|---|---|
| APP_KEY | — | |
| APP_URL | — | |
| DB_PASSWORD | — |
Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packageNot checked
- Remote endpoint uses HTTPSPass
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesNot checked
README
View on GitHubAbout Relaticle
Relaticle is a self-hosted CRM your AI agents can work in. Connect Claude, ChatGPT, or an open-source model over MCP to read, write, and analyze your CRM data. Custom fields, REST API, and multi-workspace isolation.
Built for: people who sell to a named list of companies without a sales team. Connect Claude, ChatGPT, or your own agent to work in the CRM.
Core Strengths:
- Agent-Native Infrastructure - MCP server and REST API with full CRUD, schema access, activity history, and pipeline analysis
- Customizable Data Model - Custom fields for text, dates, currency, selects, and links between records, with per-field encryption. No migrations needed.
- Multi-Workspace Isolation - Workspace-scoped data with role-based permissions
- Modern Tech Stack - Laravel 13, Filament 5, PHP 8.5, with an automated test suite on every change
- Privacy-First - Self-hosted, AGPL-3.0, your data stays on your server
Connect an agent
Relaticle ships an MCP server, so the agents you already use can work in your CRM.
- Claude: add a connector with the URL
https://mcp.relaticle.com(hosted) orhttps://your-host/mcp(self-hosted). - ChatGPT: install Relaticle from the plugin directory.
- Claude Code, Cursor, Gemini CLI: plugins and the extension live in relaticle/agent-plugins.
- Anything else that speaks MCP: Streamable HTTP, OAuth 2.1 or a personal access token, one workspace per connection. Setup in the MCP guide.
Run with Docker
The fastest way to self-host. Six containers: the app, a queue worker, a scheduler, a websocket server, PostgreSQL, and Redis.
- Download the compose file:
curl -o compose.yml https://raw.githubusercontent.com/Relaticle/relaticle/main/compose.yml
- Generate an application key:
echo "APP_KEY=base64:$(openssl rand -base64 32)"
- Create a
.envfile with your settings:
APP_KEY=base64:your-generated-key-here
DB_PASSWORD=your-secure-database-password
APP_URL=https://crm.example.com
- Start the containers:
docker compose up -d
- Create your admin account:
docker compose exec app php artisan make:filament-user
Your CRM is now available at {APP_URL}/app. The Self-Hosting Guide covers configuration, updates, backups, and a manual deployment. The sections below are for running from source.
Requirements
- PHP 8.5+
- PostgreSQL 17+
- Composer 2 and Node.js 22+
- Redis for queues (optional for development)
Installation
git clone https://github.com/Relaticle/relaticle.git
cd relaticle && composer app-install
Development
# Start everything (server, queue, vite)
composer dev
# Run tests
composer test
# Format code
composer lint
Self-Hosting
See the Self-Hosting Guide for Docker and manual deployment instructions.
Internationalization
Relaticle ships English-only in the main repository, but the codebase is fully i18n-ready. Self-host forks can drop a lang/<locale>/ directory in place to translate the entire app. See docs/i18n.md for the override workflow and CI guardrails.
Documentation
Visit our documentation for guides on business usage, technical architecture, MCP server setup, REST API integration, and more.
Community & Support
- Report Issues
- Request Features
- Ask Questions
- Star us on GitHub to support the project
License
Relaticle is open-source software licensed under the AGPL-3.0 license. The one exception is packages/Cloud, the code behind relaticle.com, which its own license governs. Everything else stays AGPL-3.0.
- Software that talks to Relaticle only through its REST API or MCP server can use any license, including a proprietary one. See the Integration Exception.
- The Relaticle name and logo are trademarks of Relaticle, Inc. If you host Relaticle for others or ship a modified version, use your own name. See the Trademark Policy.
- Contributors sign a Contributor License Agreement on their first pull request.
Star History
Relaticle MCP questions
How do I add Relaticle MCP to Claude Code?
Run claude mcp add --transport http relaticle https://mcp.relaticle.com/ in your terminal. Add --scope user to make it available in every project.
How do I add Relaticle MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What can an AI agent do with the Relaticle MCP server?
Agents can read, write, and analyze CRM data, including full CRUD, schema access, activity history, and pipeline analysis.
How does authentication work for the MCP connection?
Connections use Streamable HTTP with OAuth 2.1 or a personal access token, scoped to one workspace each.
Can I self-host Relaticle?
Yes, it is self-hosted and AGPL-3.0 licensed, with a Docker setup of six containers covering the app, worker, scheduler, websocket server, PostgreSQL, and Redis.
Does Relaticle support custom fields?
Yes, it supports custom fields for text, dates, currency, selects, and links between records, with per-field encryption and no migrations needed.