How do I install the cpersona mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `CPERSONA_DB_PATH`, `EMBEDDING_MODE`, `EMBEDDING_HTTP_URL`, `CPERSONA_AUTH_TOKEN`, `CPERSONA_EMBEDDING_URL`, `CPERSONA_HTTP_HOST` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Cpersona MCP Server

Give Claude persistent memory across sessions. Single SQLite file. 29 tools. Zero LLM dependency.

Local serverstdioPython

What is the Cpersona MCP Server?

Give Claude persistent memory across sessions. Single SQLite file. 29 tools. Zero LLM dependency.

What it actually does

Declarative memory — — Individual facts, decisions, instructions stored via store
Episodic memory — — Conversation summaries archived via archive_episode
Profile memory — — Accumulated user/project attributes via update_profile
Cosine similarity (semantic relevance)
Dynamic time decay (adapts to corpus time range — a 1-year-old corpus and a 1-day-old corpus use different decay curves)
Recall boost (frequently useful memories surface more easily, with natural fade-out)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
store	Store a message in agent memory
recall	Recall relevant memories (vector + FTS5 + keyword, RRF merge)
recall_with_context	Recall with external conversation context (auto-dedup)
get_contents	Expand recall preview refs (mem:<id> / ep:<id>) to full content
get_profile	Get current agent profile
update_profile	Save pre-computed agent profile
get_operating_context	Read the operator-owned operating context served to every client (read-only; edited on the filesystem)
archive_episode	Archive conversation episode with summary and keywords
list_memories	List recent memories
list_episodes	List archived episodes
update_memory	Update memory content (rejects if locked)
lock_memory	Lock memory to prevent deletion/editing
unlock_memory	Unlock memory to allow deletion/editing
delete_memory	Delete a single memory (ownership enforced)

How to install the Cpersona MCP Server

{
  "mcpServers": {
    "cpersona": {
      "command": "uvx",
      "args": ["cpersona"],
      "env": {
        "CPERSONA_DB_PATH": "your-value",
        "EMBEDDING_MODE": "your-value",
        "EMBEDDING_HTTP_URL": "your-value",
        "CPERSONA_AUTH_TOKEN": "your-value",
        "CPERSONA_EMBEDDING_URL": "your-value",
        "CPERSONA_HTTP_HOST": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Variable	Description	Required
CPERSONA_DB_PATH	Filesystem location the server is allowed to use.	Optional
EMBEDDING_MODE	Configuration value read at startup.	Optional
EMBEDDING_HTTP_URL	Endpoint or connection string the server talks to.	Yes
CPERSONA_AUTH_TOKEN	Credential the server authenticates with.	Yes
CPERSONA_EMBEDDING_URL	Endpoint or connection string the server talks to.	Yes
CPERSONA_HTTP_HOST	Endpoint or connection string the server talks to.	Optional

Example prompts to try

“Use Cpersona to store.”
“Use Cpersona to recall.”
“Use Cpersona to recall with context.”

Frequently asked questions

Give Claude persistent memory across sessions. Single SQLite file. 29 tools. Zero LLM dependency. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.