Hermit CRM
A one-person CRM kept as Markdown files in git, which your agent can read and update
- Pricing
- Open source
- Platforms
- macOS, Linux, CLI
- Runs
- Locally
- Version
- 1.1.0
- Listing updated
- 3 days ago
About Hermit CRM
Hermit CRM is an open-source MCP server for sales and crm. It runs locally on your machine and is started by your AI client.
Hermit CRM stores a company as a folder and a contact or conversation as a small text file, all in a git repository on your own computer. Every change is a commit you can undo, and an assistant can read and edit those files as easily as you can. The MCP server runs locally over stdio and needs a path to your data folder, created with the init command.
The web app, served on localhost, includes a pipeline board, calendar, tasks, contacts, message history, reports and a follow-up radar for unanswered threads. An outreach feature researches a company's website, drafts a first message or follow-up in your wording and waits for approval, then learns from your edits as lessons you accept one by one. You can also ask your own AI tool to build a custom dashboard from one sentence.
It targets a single person: it suits founders and freelancers, not teams sharing a pipeline, and Windows is not supported. The project is Apache 2.0 and comes with no warranty.
Install
Run in a terminal
claude mcp add hermit-crm --env HERMITCRM_DATA='<HERMITCRM_DATA>' -- uvx hermitcrmAdd to claude_desktop_config.json
{
"mcpServers": {
"hermit-crm": {
"command": "uvx",
"args": [
"hermitcrm"
],
"env": {
"HERMITCRM_DATA": "<HERMITCRM_DATA>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"hermit-crm": {
"command": "uvx",
"args": [
"hermitcrm"
],
"env": {
"HERMITCRM_DATA": "<HERMITCRM_DATA>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"hermit-crm": {
"type": "stdio",
"command": "uvx",
"args": [
"hermitcrm"
],
"env": {
"HERMITCRM_DATA": "<HERMITCRM_DATA>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"hermit-crm": {
"command": "uvx",
"args": [
"hermitcrm"
],
"env": {
"HERMITCRM_DATA": "<HERMITCRM_DATA>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"hermit-crm": {
"command": "uvx",
"args": [
"hermitcrm"
],
"env": {
"HERMITCRM_DATA": "<HERMITCRM_DATA>"
}
}
}
}Configuration
HERMITCRM_DATAPath to your Hermit CRM data folder (made with `hermitcrm init`).Required
What it does
- Plain-text records
- Companies, contacts and conversations are files you can grep and diff.
- Git history
- Each change is a commit that can be undone.
- Pipeline and calendar
- Board, due items and meeting briefs in a local web app.
- Outreach drafting
- Researches a site and drafts messages for your approval.
- Custom dashboards
- Describe a page and your AI builds it.
- Local MCP server
- Lets an agent read and update the pipeline.
Good for
- Keep a freelancer's pipeline in files you own
- Ask an agent which replies you owe
- Draft follow-ups in your own wording
- Review monthly funnel and conversion numbers
Pricing
Open source
Free and open source (Apache 2.0)
Prices change. Check hermitcrm.io before you buy.
Hermit CRM FAQ
Does it need an account?
No. There is no account and no cloud.
Which systems are supported?
macOS is supported, Linux works but is less tested, and Windows is not supported yet.
Is it for teams?
No. The README says it does not fit teams sharing a pipeline.
How do I install it?
With uv tool install hermitcrm, or ask an AI coding tool to follow INSTALL.md.
Is Hermit CRM free?
Yes. Hermit CRM is open source, so you can use and self-host it for free.
How do I add Hermit CRM to Claude Code?
Run this command in your terminal: claude mcp add hermit-crm --env HERMITCRM_DATA='<HERMITCRM_DATA>' -- uvx hermitcrm
What are the best alternatives to Hermit CRM?
The closest alternatives to Hermit CRM are Calven, CompanyData, MisarReach MCP Server, NeuralVerge and ASTra.
Alternatives to Hermit CRM

Calven
MCP serverProduct marketing context from Calven delivered into Claude, ChatGPT and other AI tools
Not checked yet- Remote
- Free trial
- 3 GitHub stars
- Marketing and SEO

CompanyData
MCP serverSearch and enrich company records from official registers via the CompanyData API
- 3 tools
- Remote
- Paid
- 3 GitHub stars
- Analytics and data

MisarReach MCP Server
MCP serverFind, enrich and score B2B leads and run outreach sequences from an AI assistant
- 31 tools
- Remote
- Freemium
- 1 GitHub star
- Sales and CRM

NeuralVerge
MCP serverStructured, source-tagged business and people data from 300+ sources for agents
- 200 tools
- Remote
- Free trial
- 1 GitHub star
- Web search and scraping

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents

CARTESIAN ECU
MCP serverCheck and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)
Not checked yet- 5 tools
- Remote
- Paid
- Files and documents