Skip to content
MCP server

Hermit CRM

A one-person CRM kept as Markdown files in git, which your agent can read and update

Runs locallyStatus and history
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 hermitcrm

Add 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

  1. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  2. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data
  3. Find, enrich and score B2B leads and run outreach sequences from an AI assistant

    • 31 tools
    • Remote
    • Freemium
    • 1 GitHub star
    • Sales and CRM
  4. NeuralVerge

    MCP server

    Structured, source-tagged business and people data from 300+ sources for agents

    • 200 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Web search and scraping
  5. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  6. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents