keepsake-mcp

MCP server for Keepsake — the personal CRM that helps you nurture your relationships.

Connect your AI assistant (Claude, Cursor, or any MCP-compatible client) to your Keepsake data: contacts, interactions, tasks, notes, daily journal, companies, and tags.

Why

Your AI assistant becomes a personal relationship manager. Ask it to:

• "Who did I last talk to at Acme Corp?"
• "Add a note that I ran into Sarah at the conference"
• "What tasks are overdue?"
• "Show me everything related to the #house-project tag"
• "Create a follow-up task for my meeting with John next week"

Quick start

1. Get your API key

Sign up at keepsake.place, then go to Account > API Keys to generate one.

2. Choose your connection method

Option A: Remote (HTTP) — recommended

No installation required. Works with Claude iOS, Claude web, Claude Desktop Connectors, and any MCP client that supports Streamable HTTP.

Endpoint: https://app.keepsake.place/api/mcp

Authentication: Pass your API key as a Bearer token in the Authorization header.

Claude Desktop (Connectors):

Add a remote MCP server in Claude Desktop settings with:

• URL: https://app.keepsake.place/api/mcp
• Authentication: Bearer token with your ksk_ API key

Any MCP client (Streamable HTTP):

{
  "mcpServers": {
    "keepsake": {
      "type": "streamable-http",
      "url": "https://app.keepsake.place/api/mcp",
      "headers": {
        "Authorization": "Bearer ksk_YOUR_API_KEY"
      }
    }
  }
}

Option B: Local (stdio)

Runs locally via npx. Useful for Claude Code, Cursor, and local development.

Claude Desktop:

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "keepsake": {
      "command": "npx",
      "args": ["-y", "keepsake-mcp"],
      "env": {
        "KEEPSAKE_API_KEY": "ksk_YOUR_API_KEY"
      }
    }
  }
}

Claude Code:

claude mcp add keepsake -- npx -y keepsake-mcp

Then set KEEPSAKE_API_KEY in your environment.

Cursor:

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "keepsake": {
      "command": "npx",
      "args": ["-y", "keepsake-mcp"],
      "env": {
        "KEEPSAKE_API_KEY": "ksk_YOUR_API_KEY"
      }
    }
  }
}

Available tools (58)

Contacts

Tool	Description
list_contacts	List all contacts with pagination and sorting
get_contact	Get a contact with recent interactions, tags, and stats
create_contact	Create a new contact
update_contact	Update contact fields
delete_contact	Permanently delete a contact
search_contacts	Accent-insensitive search by name, email, company
get_contact_timeline	Unified chronological feed of all items for a contact

Companies

Tool	Description
list_companies	List all companies
get_company	Get company with linked contacts and tags
create_company	Create a new company
update_company	Update company fields
delete_company	Soft-delete (or permanent delete) a company
search_companies	Accent-insensitive company search

Entries (Interactions)

Tool	Description
list_entries	List interactions (calls, emails, meetings, etc.)
create_entry	Log a new interaction — supports #tag# and [[tag]] syntax
update_entry	Update an interaction
delete_entry	Delete an interaction

Tasks

Tool	Description
list_tasks	List tasks with status/date filters
create_task	Create a task — supports #tag# and [[tag]] syntax
update_task	Update task fields
delete_task	Delete a task
complete_task	Mark as completed (auto-creates next occurrence for recurring task

... View full README on GitHub