# GhostPaw Affinity

> GhostPaw Affinity is an open-source MCP server for sales and crm. Local SQLite relationship CRM that tracks contacts, promises and drift. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://affinity.ghostpaw.dev
- **Repository:** https://github.com/ghostpawjs/affinity
- **MCP Registry name:** io.github.GhostPawJS/affinity
- **Categories:** sales and CRM, knowledge and memory
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "affinity": {
      "command": "npx",
      "args": [
        "-y",
        "@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

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.

---
Source: https://ai-powered.com/mcp/ghostpaw-affinity
