Contrack MCP server
Commit Nov 11, 2026Lets an AI client manage contacts, log notes, and look up relationship context through a self-hosted personal CRM.
Also known as arvarik/contrack
- Stars
- 117
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 11, 2026
- License
- AGPL-3.0
What is Contrack MCP?
Contrack lets an AI client manage contacts, log notes, and look up relationship context through a self-hosted personal CRM.
Summary generated from the project's README
About Contrack MCP server
Managing personal relationships and contact details through an AI assistant is what contrack enables. This self-hosted personal CRM allows users to import contacts from various sources like Google, LinkedIn, or Apple and consolidate them into a single, clean profile. By running the server locally via Docker or Node.js, you maintain complete ownership of your data without needing a cloud account or API keys.
Users can connect AI clients such as Claude, ChatGPT, or Cursor to their local instance to look up relationship context or log new notes. The system handles deduplication, contact enrichment through web research, and automated reminders. It is designed for individuals, families, or teams who want a private way to track milestones, birthdays, and meeting notes while keeping address books isolated between different user profiles.
What you can do with it
- 1Consolidate scattered contact listsMerge duplicate entries from different platforms into a single unified profile.
- 2Enrich profiles with researchUse web research to automatically fill in professional roles and links for your contacts.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablearvarik/contrack is public and reachablegithub.com/arvarik/contrack ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-11github.com/arvarik/contrack ↗Pass
- OpenSSF ScorecardOpenSSF Scorecard 8.0 / 10; weakest: Code-Review 0, Fuzzing 0, Contributors 3scorecard.dev/viewer/?uri=github.com/arvarik/contrack ↗Pass
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubContacts are scattered all over your apps, often have a large overlap, and aren't necessarily filled in with the most amount of information you'd like. When every app requests access to your contacts, it doesn't really feel like you own your network.
And even when you meticulously update your private Apple contacts, there's no good way to keep building the relationship or continuously updating their important details.
Contrack solves all of these by being an all-in-one, self-hosted contact management app that a follows a simple 4 step process:
Import → Dedupe → Enrich → Track
Highlights
And everything else you expect: rich notes with file & image attachments, @mentions that link people together, custom dates and anniversaries, lists and tags, passkey sign-in, a 90-day trash with undo, open exports anytime, and warm light and dark themes.
Privacy
Privacy isn't a setting. It's the foundation. Contrack lives on your own computer or home server. Your relationships aren't training anyone's model, sitting on a rented cloud, or locked behind a monthly subscription. Search happens right on your device.
Share one home server with your family or team while keeping everyone's address book completely private to them. And when you want AI to research a contact or turn a quick note into a rich profile, you bring the model you trust, or use none at all.
Comparing personal CRMs?
- Contrack vs Monica
- Contrack vs Clay
- Contrack vs Folk
- Contrack vs Twenty
- Contrack vs Huly
- Contrack vs EspoCRM
- Contrack vs Nextcloud Contacts.
Start in a minute
Run Contrack on your machine with Docker:
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. There is no cloud account to sign up for and no API key required. Everything stays in your contrack-data folder. Whenever you want AI features, open Settings → Administration → AI.
Docker Compose with the published image:
services:
contrack:
image: ghcr.io/arvarik/contrack:latest
container_name: contrack
restart: unless-stopped
ports:
- "127.0.0.1:3210:3210"
volumes:
- contrack-data:/app/data
environment:
- AUTH_REQUIRED=false # Set to true before exposing beyond localhost
volumes:
contrack-data:
Or build the image from this repository:
git clone https://github.com/arvarik/contrack.git && cd contrack
docker compose up -d
From source, with Node.js 26.13 or later:
git clone https://github.com/arvarik/contrack.git && cd contrack
npm install
npm run dev
For your household or team: turn on sign-in with -e AUTH_REQUIRED=true. Your first visit creates the admin profile, and you can invite family or teammates from Settings → Administration → Accounts. See the Self-hosting guide for remote access, backups, and upgrades.
Try it in your browser
Open a live demo in your browser preloaded with 400 fictional people, with no installation and no API key needed.
Contrack MCP questions
How can I connect my AI assistant to Contrack?
You can connect Claude, ChatGPT, or Cursor in one click to allow your assistant to look up context and log notes.
Does Contrack require an API key to start?
No, there is no API key required for the initial setup; everything stays in your local data folder.
Can I use Contrack for my team or family?
Yes, you can run one instance for a family or team where every person gets their own private address book and notes.