GhostPaw Affinity
Local SQLite relationship CRM that tracks contacts, promises and drift
- 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/affinityAdd to claude_desktop_config.json
{
"mcpServers": {
"affinity": {
"command": "npx",
"args": [
"-y",
"@ghostpaw/affinity"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"affinity": {
"command": "npx",
"args": [
"-y",
"@ghostpaw/affinity"
]
}
}
}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

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Claude Code Ultimate Guide
MCP serverMCP 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

Nautilus Compass Memory
MCP serverLocal-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

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