# Codeman (MCP server)

> Codeman is an MCP server that adds developer tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Start, prompt and read AI coding agent sessions (Claude Code, Codex, Gemini CLI and more) in Codeman. It has 814 GitHub stars, is released under the MIT license and runs locally with npx -y aicodeman.

Claude Code • OpenCode • Codex • Antigravity • Gemini • Pi • Grok • DeepSeek • OMP • Copilot • Terminal - One Dashboard • Any Device

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/Ark0N/Codeman |
| GitHub stars | 814 |
| License | MIT |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: aicodeman |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Developer tools |
| Latest release | codeman@1.45.0 (Oct 24, 2026) |
| Last commit | Oct 24, 2026 |
| MCP registry name | io.github.Ark0N/codeman |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "codeman": {
      "command": "npx",
      "args": [
        "-y",
        "aicodeman"
      ],
      "env": {
        "CODEMAN_API_URL": "your-value",
        "CODEMAN_PASSWORD": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env CODEMAN_API_URL=your-value --env CODEMAN_PASSWORD=your-value --transport stdio codeman -- npx -y aicodeman
```

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

```json
{
  "mcpServers": {
    "codeman": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "aicodeman"
      ],
      "env": {
        "CODEMAN_API_URL": "your-value",
        "CODEMAN_PASSWORD": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

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

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "codeman_password",
      "description": "CODEMAN_PASSWORD",
      "password": true
    }
  ],
  "servers": {
    "codeman": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "aicodeman"
      ],
      "env": {
        "CODEMAN_API_URL": "your-value",
        "CODEMAN_PASSWORD": "${input:codeman_password}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `CODEMAN_API_URL` (required): Where your Codeman server runs, for example https://127.0.0.1:3000. Never guessed.
- `CODEMAN_PASSWORD` (secret): Codeman's HTTP Basic password, when the server has one.

## Similar MCP servers

- [Idea Reality MCP](https://appsgit.com/mcp-servers/idea-reality-mcp): Pre-build reality check. Scans GitHub, HN, npm, PyPI, Product Hunt — returns 0-100 signal. (827 stars, MIT)
- [Nova3D](https://appsgit.com/mcp-servers/nova3d): Structured, part-aware 3D generation for AI agents. (733 stars, MIT, needs API key)
- [Figma MCP Bridge](https://appsgit.com/mcp-servers/figma-mcp-bridge): Figma Plugin & MCP server to bypass API limits. (832 stars, MIT)
- [Wcgw](https://appsgit.com/mcp-servers/wcgw): Shell and coding agent on mcp clients. (678 stars, Apache-2.0)
- [Skylos](https://appsgit.com/mcp-servers/skylos): Dead code, security, secrets detection and code quality for Python, TypeScript, Go. (852 stars, Apache-2.0, needs API key)
- [Concord MCP](https://appsgit.com/mcp-servers/concord-mcp): Cross-harness communication and shared work-state for AI coding agents. (676 stars, MIT)

---

Canonical page: https://appsgit.com/mcp-servers/codeman
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.