USRCP — User Context Protocol
Encrypted local ledger that lets your AI tools share preferences, projects and recent work
- Pricing
- Open source
- Platforms
- CLI, self-hosted, macOS
- Runs
- Locally
- Version
- 0.2.8
- Listing updated
- 2 days ago
About USRCP — User Context Protocol
USRCP — User Context Protocol is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add usrcp --env USRCP_PASSPHRASE='<USRCP_PASSPHRASE>' -- npx -y usrcpAdd to claude_desktop_config.json
{
"mcpServers": {
"usrcp": {
"command": "npx",
"args": [
"-y",
"usrcp"
],
"env": {
"USRCP_PASSPHRASE": "<USRCP_PASSPHRASE>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"usrcp": {
"command": "npx",
"args": [
"-y",
"usrcp"
],
"env": {
"USRCP_PASSPHRASE": "<USRCP_PASSPHRASE>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"usrcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"usrcp"
],
"env": {
"USRCP_PASSPHRASE": "<USRCP_PASSPHRASE>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"usrcp": {
"command": "npx",
"args": [
"-y",
"usrcp"
],
"env": {
"USRCP_PASSPHRASE": "<USRCP_PASSPHRASE>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"usrcp": {
"command": "npx",
"args": [
"-y",
"usrcp"
],
"env": {
"USRCP_PASSPHRASE": "<USRCP_PASSPHRASE>"
}
}
}
}Configuration
USRCP_PASSPHRASEPassphrase used to derive the ledger encryption key. Omit it if the passphrase is stored in the OS keychain via `usrcp keychain store`.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- usrcp_get_state
- Read recent activity across the profile
- usrcp_handoff
- Request a focused live brief
What it does
- 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
Pricing
Open source
Apache 2.0, free; early beta
Prices change. Check usrcp.dev before you buy.
USRCP — User Context Protocol 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 to USRCP — User Context Protocol

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

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity
MedXpert 图书馆连接器(通用版)
MCP serverLocal MCP server that searches and answers questions over your own Markdown wiki
Runs locally- 4 tools
- Open source
- Knowledge and memory