manukminasyan/relaticle repository overview

⁠Relaticle

Open-source CRM your AI agents can read and update: companies, people, opportunities, tasks and notes. Connect Claude, ChatGPT, Cursor or any MCP client, or use the REST API. Custom fields, multi-workspace isolation, AGPL-3.0.

Canonical image: ghcr.io/relaticle/relaticle. This repository mirrors the same builds; main tracks the main branch and each commit SHA has its own tag.

⁠Run with Docker

Six containers: the app, a queue worker, a scheduler, a websocket server, PostgreSQL, and Redis.

1. Download the compose file:

curl -o compose.yml https://raw.githubusercontent.com/Relaticle/relaticle/main/compose.yml

1. Generate an application key:

echo "APP_KEY=base64:$(openssl rand -base64 32)"

1. 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

1. Start the containers:

docker compose up -d

1. Create your admin account:

docker compose exec app php artisan make:filament-user

Your CRM is now available at {APP_URL}/app.

⁠Connect an agent

• Claude: add a connector with the URL https://your-host/mcp.
• 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⁠.

⁠Links

• Self-Hosting Guide⁠: configuration, updates, backups, manual deployment
• Source on GitHub⁠
• Documentation⁠
• Discord⁠