Skip to content
MCP server

Commons

Shared memory, work claims and handoffs so parallel coding sessions don't collide

Runs locallyStatus and history
Install
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.0

Add to claude_desktop_config.json

{
  "mcpServers": {
    "commons-memory": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/neoo-blue/commons-memory:0.41.0"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "commons-memory": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/neoo-blue/commons-memory:0.41.0"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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 Commons
  • COMMONS_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.

How AIPoweredBot checks servers