Contrack MCP
A self-hosted contact CRM with a built-in MCP server: 18 tools for finding people, logging interactions and follow-ups.
- 116 ★ on the repository
- Last commit
- AGPL-3.0
Extended access
Why this level
- Write tools change and delete contacts and follow-ups, and contacts hold personal data.
Install
- Works in
Manual install
docker run -d --name contrack -p 127.0.0.1:3210:3210 -v contrack-data:/app/data ghcr.io/arvarik/contrack:latestCommand from the Start in a minute section. MCP is connected in Settings, the MCP and API section.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Write tools change and delete contacts and follow-ups, and contacts hold personal data.
This is third-party code. Review the repository files before installing.
What it does
Contrack is a contact management app that runs in Docker on your side: import, dedupe, data enrichment and relationship tracking. The app has an MCP server at `/api/mcp` (sessionless Streamable HTTP) that Claude Code, Claude, ChatGPT, Cursor, VS Code, Codex and Gemini CLI connect to. Setup is step by step in Settings, the "MCP and API" section. There are 18 tools: nine for reading (`search_people`, `get_contact`, `list_contacts`, `get_timeline`, `search_notes`, `list_action_items`, `get_pulse`, `list_tags`, `list_lists`) and nine for writing, including `create_contact`, `log_interaction`, `create_action_item` and `add_to_list`. `ctk_` tokens can be read-only, and then the client sees only read tools.
Who it is for. People who keep a business and personal network on their own server and want an agent to find people and log conversations.
Good fit when
- Before a meeting the agent pulls a person profile and interaction history.
- After a call a note is logged and the agent links the mentioned people.
- `list_action_items` gathers overdue follow-ups for contacts.
- A read-only token is issued for safety.
Not a fit when
- A cloud CRM with team collaboration is needed.
- Contacts cannot reach a model even as a query.
- Node.js older than 26.13 is required to run from source.
Example request
Find people in Berlin I have not spoken to for over three months and propose a follow-up date for each.MCP
- Transport
- http
- Authentication
- OAuth
Limitations
Write tools can overwrite or remove data: clients may ask confirmation for `update_contact`, `update_action_item` and `remove_from_list`. Issue read-only tokens where writes are not needed. Text written by other people arrives inside `<untrusted_data>` tags, as data rather than instructions. Tokens last 90 days by default, with a limit of 10 tokens per hour. The app is licensed AGPL-3.0. An address reachable only from your computer suits local clients alone; cloud clients need a public address.
How to disable. Revoke tokens on the Settings tokens page, remove the server entry from the client and stop the `contrack` container. Data lives in the `contrack-data` volume.
FAQ
How do I start it?
With `docker run -d --name contrack -p 127.0.0.1:3210:3210 -v contrack-data:/app/data ghcr.io/arvarik/contrack:latest`, then open `http://localhost:3210`.
Is a cloud account needed?
No. No cloud sign-up or API keys are needed to run; data lives in the `contrack-data` folder.
How do I connect a client?
In Settings open "MCP and API", pick a client, create a token or sign in via the browser and copy the command or config.
How many results do tools return?
People search up to 30, note search up to 50, lists up to 100 entries at a time with a `nextCursor` cursor.
Can I forbid changes?
Yes, create a token with "Read only" access: the client then sees read tools only.
Discussion
No questions or reviews yet.
Related
MCP serversOpen-source CRM for small teams with MCP: contacts, deals and tasks open to Claude and other agents, with reply drafts left to you
Attio MCP Server: Attio CRM for Claude and ChatGPT
Attio MCP Server
An MCP server for Attio CRM: companies, people, deals, tasks, lists and notes through 19 universal tools
MCP server for amoCRM and Kommo: deals, contacts, tasks and pipeline reports, stalled deals and managers overdue tasks
MCP server for monitoring multiple Kommo accounts
Kommo MCP Server — Ventas Inteligentes
A 40-tool Kommo MCP server with two modes: local stdio for Claude Code and remote HTTP for round-the-clock tasks, built for agencies with several clients
A remote MCP server with B2B data: companies, contacts and work addresses inside the chat, browser sign-in, no API keys
MCP server of a self-hosted Pipedrive alternative: an assistant searches deals, logs activities and moves deals along the pipeline
README in short
The README says the app gathers contacts, removes duplicates, enriches data and tracks relationships; MCP is covered in a separate `docs/mcp.md` document.