# USRCP — User Context Protocol

> USRCP — User Context Protocol is an open-source MCP server for knowledge and memory. Encrypted local ledger that lets your AI tools share preferences, projects and recent work. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Linux
- **Website:** https://usrcp.dev
- **Repository:** https://github.com/frank-bot07/usrcp
- **MCP Registry name:** io.github.frank-bot07/usrcp
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-15

## About

USRCP stores structured user state in a local SQLite ledger, encrypted with AES-256-GCM under a passphrase you hold. Connected MCP clients can read it so a switch from Claude Desktop to Cursor or Codex does not mean repeating your stack and preferences. The README calls it an early beta and says automatic capture and recall depend on each integration.

Two tools are named: usrcp_get_state returns recent activity across the profile and usrcp_handoff requests a focused live brief. Adapters capture activity from GitHub, Linear, Obsidian, Claude Code sessions and Google Calendar, and there is an experimental conversation-capture set. The core uses exact-keyword lookup; an optional stream adds semantic recall with a different privacy boundary, since local embedding vectors are stored in plaintext and external embedding providers receive content after consent.

It installs with Homebrew or npm, takes the passphrase from USRCP_PASSPHRASE or the OS keychain, and is licensed Apache 2.0. The README advises verifying actual client behaviour with its two-client acceptance test, because a shared ledger alone does not prove automatic retrieval.

## Features

- **Encrypted local ledger:** SQLite store encrypted at rest with a key derived from your passphrase.
- **Cross-tool sharing:** Claude Desktop, Cursor, Continue, Cline and terminal agents can use the same profile.
- **Live handoff brief:** Request a compact summary of ongoing work from another tool.
- **Activity capture:** Adapters for GitHub, Linear, Obsidian, Claude Code sessions and Google Calendar.
- **Optional semantic recall:** A separate stream adds embedding-based search with its own boundaries.
- **Apache 2.0:** Open source with a documented threat model.

## Good for

- Continue work in Cursor that you started in Claude Code
- Keep preferences and decisions across AI tools
- Ask an assistant what you were just working on
- Capture GitHub and Linear activity into a personal timeline
- Hold your own context under a key you control

## Install

### Claude Code (Terminal)

```sh
claude mcp add usrcp --env USRCP_PASSPHRASE='<USRCP_PASSPHRASE>' -- npx -y usrcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "usrcp": {
      "command": "npx",
      "args": [
        "-y",
        "usrcp"
      ],
      "env": {
        "USRCP_PASSPHRASE": "<USRCP_PASSPHRASE>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "usrcp": {
      "command": "npx",
      "args": [
        "-y",
        "usrcp"
      ],
      "env": {
        "USRCP_PASSPHRASE": "<USRCP_PASSPHRASE>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "usrcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "usrcp"
      ],
      "env": {
        "USRCP_PASSPHRASE": "<USRCP_PASSPHRASE>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "usrcp": {
      "command": "npx",
      "args": [
        "-y",
        "usrcp"
      ],
      "env": {
        "USRCP_PASSPHRASE": "<USRCP_PASSPHRASE>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "usrcp": {
      "command": "npx",
      "args": [
        "-y",
        "usrcp"
      ],
      "env": {
        "USRCP_PASSPHRASE": "<USRCP_PASSPHRASE>"
      }
    }
  }
}
```

## Tools

- `usrcp_get_state`: Read recent activity across the profile
- `usrcp_handoff`: Request a focused live brief

## FAQ

### Where is my data stored?

In a local encrypted SQLite ledger; the optional device relay syncs only timeline and stream events as ciphertext.

### How is the passphrase supplied?

Through USRCP_PASSPHRASE, or from the OS keychain after usrcp keychain store.

### Is retrieval automatic?

Not guaranteed. The README says clients must honour the startup instructions and recommends running its acceptance test.

### Which licence?

Apache 2.0.

### Is USRCP — User Context Protocol free?

Yes. USRCP — User Context Protocol is open source, so you can use and self-host it for free.

### How do I add USRCP — User Context Protocol to Claude Code?

Run this command in your terminal: claude mcp add usrcp --env USRCP_PASSPHRASE='<USRCP_PASSPHRASE>' -- npx -y usrcp

### What are the best alternatives to USRCP — User Context Protocol?

The closest alternatives to USRCP — User Context Protocol are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## 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.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/usrcp-user-context-protocol
