Skip to content
MCP server

GhostPaw Affinity

Local SQLite relationship CRM that tracks contacts, promises and drift

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.7.2
Listing updated
3 days ago

About GhostPaw Affinity

GhostPaw Affinity is an open-source MCP server for sales and crm. It runs locally on your machine and is started by your AI client.

Affinity treats a relationship as a record of what happened rather than a score you set. You log interactions, promises and yearly dates in a SQLite file under ~/.ghostpaw, and it derives relationship rank, trust and drift from that evidence.

The site walks through a replay: after an evening out with one contact, his drift falls and he drops to the bottom of the radar, while a recorded promise lowers the other person's trust until it is resolved. Calls such as listRadar and listOpenCommitments show who needs attention and what is still owed.

It ships as a binary that needs no runtime, an npm package with zero runtime dependencies (Node.js 24 or newer) and a library for agent harnesses. Running the binary with the mcp argument starts the MCP server. It is free under the MIT licence and nothing leaves your machine.

Install

Run in a terminal

claude mcp add affinity -- npx -y @ghostpaw/affinity

Add to claude_desktop_config.json

{
  "mcpServers": {
    "affinity": {
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/affinity"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "affinity": {
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/affinity"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "affinity": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/affinity"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "affinity": {
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/affinity"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "affinity": {
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/affinity"
      ]
    }
  }
}

Configuration

  • GHOSTPAW_AFFINITY_DBSQLite database path (default: ~/.ghostpaw/affinity.db)

What it does

Drift and trust
Derives rank, trust and drift from recorded interactions instead of manual scores.
Promise tracking
Commitments stay open until resolved and affect trust.
Yearly dates
Stores recurring dates that matter to each contact.
Radar view
Lists contacts by drift so the person most overdue comes first.
Local SQLite storage
Everything lives in one database file on your machine.
Three ways to run
Use the binary, the npm package or the Node.js library.

Good for

  • Give an agent a memory of the people you deal with
  • Remember promises made to colleagues and clients
  • Decide who to call next based on how long it has been
  • Track birthdays and other yearly dates

Pricing

Open source

Free, MIT licensed

Prices change. Check affinity.ghostpaw.dev before you buy.

GhostPaw Affinity FAQ

Where is the data stored?

In a SQLite file, by default ~/.ghostpaw/affinity.db, which you can move with GHOSTPAW_AFFINITY_DB.

What licence is it under?

MIT, and it is free.

What do I need to install it?

The standalone binary needs no runtime. The npm package needs Node.js 24 or newer.

How do I start the MCP server?

Run ghostpaw-affinity mcp after installing the binary.

Is GhostPaw Affinity free?

Yes. GhostPaw Affinity is open source, so you can use and self-host it for free.

How do I add GhostPaw Affinity to Claude Code?

Run this command in your terminal: claude mcp add affinity -- npx -y @ghostpaw/affinity

What are the best alternatives to GhostPaw Affinity?

The closest alternatives to GhostPaw Affinity are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and Calven.

Alternatives to GhostPaw Affinity

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  5. 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
  6. 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