# komnet

> komnet is a free MCP server for developer tools. Message bus that lets AI coding agents on different machines coordinate through a git repo. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/komdosh/komnet/tree/HEAD/packages/cli
- **MCP Registry name:** io.github.Komdosh/komnet
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add komnet -- npx -y komnet
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "komnet": {
      "command": "npx",
      "args": [
        "-y",
        "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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/komnet
