relaticle /relaticle

Open-source CRM your AI agents can read and update: companies, people, opportunities, tasks and notes. REST API, self-hosted or cloud.

★ 1,845⑂ 233👁 7⑃ 1,066● 110▤ 107
PHPAGPL-3.0Created 2024-09-25relaticle.com
Download: v3.9.2v3.9.2 ↓3.9.22026-11-13
+1
Daily
1,845
stars
233
forks
7
watchers
1,066
prs
110
issues
107
releases

README

The Open-Source AI CRM for Selling Without a Sales Team


  
  
  
  
  



  Website ·
  Documentation ·
  MCP Server ·
  Roadmap ·
  Discord



  
    
    
  
  
  One request to Rela, the built-in AI assistant: three changes, applied after you approve them.


---

 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.

1. Download the compose file:

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


2. Generate an application key:

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


3. Create a .env file with your settings:

bash
APP_KEY=base64:your-generated-key-here
DB_PASSWORD=your-secure-database-password
APP_URL=https://crm.example.com


4. Start the containers:

bash
docker compose up -d


5. Create your admin account:

bash
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

bash
git clone https://github.com/Relaticle/relaticle.git
cd relaticle && composer app-install


 Development

bash
 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 inst

Top issues

Latest release

v3.9.2 v3.9.2 2026-11-13
What's Changed
 fix(workspaces): require a verified email to join, decline or connect by @ManukMinasyan in https://github.com/relaticle/relaticle/pull/1168
 fix(records): check permission before linking tasks and notes from a record by @ManukMinasyan in https://github.com/relaticle/relaticle/pull/1169
 fix(sysadmin): keep plan changes on reset period to super administrators by @ManukMinasyan in https://github.com/relaticle/relaticle/pull/1170
 fix(custom-fields): refuse field changes after a member's role is lowered by @ManukMinasyan in https://github.com/relaticle/relaticle/pull/1171


Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON