About 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) or https://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
.env file 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
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
