Commons
Shared memory, work claims and handoffs so parallel coding sessions don't collide
- Pricing
- Open source
- Platforms
- CLI, self-hosted, Linux
- Runs
- Locally
- Version
- 0.41.0
- Listing updated
- today
Similar MCP servers
About Commons
Commons is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
The core scenario is several Claude Code sessions, say one per git worktree, working at once. Each session calls start_work before a task; if another session already holds it, the reply says who has it and since when, and suggests messaging them or waiting for their finish_work. Finished work, decisions and handoffs are shared, so the next session builds on them. Each folder counts as its own agent.
Everything sits in one local SQLite file with no API keys, account or telemetry. The Claude Code plugin lists 19 memory and coordination tools; credential and vault tools stay out of the list. It is meant to run alongside claude-mem and Claude Code's own memory.
A larger self-hosted hub, installable by script or Docker, extends this across machines and other AIs such as Codex, Cursor, Gemini CLI, ChatGPT and Grok. The README describes a dashboard, hybrid search, a code index, a per-project knowledge base and an infrastructure map, with 195 tools of which 41 core ones are listed by default. The registry image is distributed via ghcr.io.
Install
Run in a terminal
claude mcp add commons-memory -- docker run -i --rm ghcr.io/neoo-blue/commons-memory:0.41.0Add to claude_desktop_config.json
{
"mcpServers": {
"commons-memory": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/neoo-blue/commons-memory:0.41.0"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"commons-memory": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/neoo-blue/commons-memory:0.41.0"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"commons-memory": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/neoo-blue/commons-memory:0.41.0"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"commons-memory": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/neoo-blue/commons-memory:0.41.0"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"commons-memory": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/neoo-blue/commons-memory:0.41.0"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
COMMONS_AGENTName this client goes by in CommonsCOMMONS_TOOLSTool listing: lite, core or all
Tools this server provides (5)
Taken from the project documentation; the running server may differ.
- start_work
- Claim a task and paths, or learn who already holds them.
- finish_work
- Release a claim and record the outcome.
- msg_send
- Message another agent.
- tools
- Search the tools not listed by default.
- call
- Run a tool by name with arguments.
What it does
- Work claims
- start_work tells a session when another already owns the task and the paths.
- Handoffs and decisions
- Finished work and decisions are shared so later sessions don't start over.
- Local SQLite
- One file, no keys, no account, no telemetry.
- Trimmed tool list
- Lite, core or all tool listings control how much schema the client loads.
- Self-hosted hub
- Extends sharing across machines and AIs with a dashboard, with SQLite or Postgres.
- Hybrid search
- BM25 plus local vector search across stored memories.
Good for
- Run several Claude Code worktrees without duplicate work
- Hand unfinished work from one session to the next
- Share memory between Claude Code and Cursor
- See which agent is doing what on a dashboard
Pricing
Open source
Free; self-hosted
Commons FAQ
Does it need an account or API key?
No. The local mode uses one SQLite file with no keys, account or telemetry.
How does it identify each session?
Each folder is one agent, named claude-code@<folder>, so use separate worktrees with different folder names.
Does it replace claude-mem?
No. The README says it works alongside it: those help one session remember, Commons keeps several from colliding.
What is required to install the plugin?
uv.
Is Commons free?
Yes. Commons is open source, so you can use and self-host it for free.
How do I add Commons to Claude Code?
Run this command in your terminal: claude mcp add commons-memory -- docker run -i --rm ghcr.io/neoo-blue/commons-memory:0.41.0
What are the best alternatives to Commons?
The closest alternatives to Commons are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


