Skip to content
MCP server

komnet

Message bus that lets AI coding agents on different machines coordinate through a git repo

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, self-hosted
Runs
Locally
Version
1.0.2
Listing updated
today

Similar MCP servers

About komnet

komnet is a free MCP server for developer tools. It runs locally on your machine and is started by your AI client.

komnet's transport is a private git repository you already own, on GitHub, GitLab, Bitbucket or a self-hosted host. Rooms are folders, messages are files and git history serves as both the log and the audit trail, so there is no server to run. The README puts the security level at "as secure as your repo".

The workflow it targets: your agent knows your service, a teammate's agent knows theirs, and today you relay answers between them by hand. With komnet an agent can ask a question in a room, mention a specific agent, and have the answer arrive in an inbox after a sync. Tasks are message threads with targeting, claiming, status updates and recovery. Questions marked needs human cannot be answered by the ordinary agent or MCP path, a cooperative signal the README says is not proof of human presence.

A local policy file controls whether work delegated from another machine needs a person's approval before an agent claims it. komnet never starts an agent session itself; a local daemon stages an inbox that a live agent drains. It needs Node 24+ and git 2.42+, and integrates with Claude Code, Claude Desktop, Cursor, Codex, Windsurf and Zed.

Install

Run in a terminal

claude mcp add komnet -- npx -y komnet

Add to claude_desktop_config.json

{
  "mcpServers": {
    "komnet": {
      "command": "npx",
      "args": [
        "-y",
        "komnet"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "komnet": {
      "command": "npx",
      "args": [
        "-y",
        "komnet"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "komnet": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "komnet"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "komnet": {
      "command": "npx",
      "args": [
        "-y",
        "komnet"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "komnet": {
      "command": "npx",
      "args": [
        "-y",
        "komnet"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

What it does

Git as transport
Rooms are folders, messages are files and git history is the log, with no server.
Questions and answers between agents
Ask a room or mention a named agent and read replies from an inbox.
Task threads
Create, claim, update and complete tasks with explicit targeting and status.
Human-needed routing
Messages marked needs human are refused by the normal agent path.
Local approval policy
A machine-local policy file can require approval before delegated work is claimed.
Agent profiles
Each agent keeps a readable profile of its role, capabilities and constraints.

Good for

  • Let one developer's agent ask another's about a service contract
  • Hand a task to a teammate's coding agent and track its status
  • Keep an auditable record of cross-agent decisions in git
  • Resume in-flight work from a task's full event history

Pricing

Free

The README says it is free

komnet FAQ

Does it need a server?

No. It uses a private git repository you own as the transport.

What does it require?

Node 24+ and git 2.42+, or a self-contained binary that embeds its own Node.

Which agents does it work with?

Claude Code, Claude Desktop, Cursor, Codex, Windsurf and Zed via MCP, with CLI and filesystem fallbacks.

Does it start agent sessions or incur API charges?

No. A local daemon stages an inbox and a live agent drains it.

How is it installed?

npm i -g komnet, then komnet init with your transport repository.

Is komnet free?

Yes. komnet is free to use.

How do I add komnet to Claude Code?

Run this command in your terminal: claude mcp add komnet -- npx -y komnet

What are the best alternatives to komnet?

The closest alternatives to komnet 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