Codmir MCP Server

AI-powered project management for your coding assistant. Create tickets, manage sprints, execute tasks, debug production errors, and control your desktop — all through natural language.

Works with Claude Desktop, Claude Code, Windsurf, Cursor, and VS Code.

Install

npx @codmir/mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "codmir": {
      "command": "npx",
      "args": ["@codmir/mcp"]
    }
  }
}

Claude Code

Add to .claude/mcp.json in your project:

{
  "mcpServers": {
    "codmir": {
      "command": "npx",
      "args": ["@codmir/mcp"]
    }
  }
}

Windsurf

Add to .windsurf/mcp.json:

{
  "mcpServers": {
    "codmir": {
      "command": "npx",
      "args": ["@codmir/mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "codmir": {
      "command": "npx",
      "args": ["@codmir/mcp"]
    }
  }
}

Authentication

# Interactive login (opens browser)
codmir login

# Or set environment variables
export CODMIR_API_TOKEN="your-token"
export CODMIR_USER_ID="your-user-id"
export CODMIR_API_URL="https://codmir.com"  # optional

Credentials are stored securely in ~/.codmir/credentials.json (chmod 600).

Tools

Project Management

| Tool | Description | |------|-------------| | list_todo | List actionable tickets sorted by priority (open, in_progress, review) | | update_todo_status | Mark a ticket as done, in-progress, review, or reopen | | create_ticket | Create a new bug, feature, task, or improvement ticket | | list_project_tasks | List all tasks for a project | | get_sprint_tasks | Get tasks for current or specified sprint | | check_task_status | Check status of a running task execution |

AI Task Execution

| Tool | Description | |------|-------------| | execute_task | Run an AI-powered code task (bug fix, feature, refactor) | | store_conversation | Save conversation as project documentation | | get_project_context | Get project overview, tech stack, and activity |

Error Debugging (Overseer)

| Tool | Description | |------|-------------| | lookup_error | Look up a production error by refId, digest, reportId, fingerprint, or issueId | | list_recent_errors | List recent production errors with severity filtering | | get_error_context | Get enriched error context with suggested files and AI debugging summary |

SDK & Workspace

| Tool | Description | |------|-------------| | get_sdk_reference | Get Codmir SDK API reference for a topic | | generate_sdk_code | Generate ready-to-use TypeScript/JavaScript code | | create_organization | Create a new workspace | | create_project | Create a project within an organization | | get_workspace_status | Check workspace setup status |

Desktop Control

When the Codmir desktop app is running, these tools give AI agents direct control:

| Tool | Description | |------|-------------| | codmir_screenshot | Capture a screenshot of the entire screen | | codmir_click / codmir_double_click / codmir_right_click | Click at screen coordinates | | codmir_type | Type text at the current cursor position | | codmir_key | Press keyboard keys or key combinations | | codmir_scroll | Scroll at coordinates | | codmir_mouse_move | Move the mouse cursor | | codmir_shell | Run a shell command on the desktop machine | | codmir_screen_info | Get screen dimensions and frontmost app | | codmir_fetch_page | Fetch a web page through the desktop agent | | codmir_scan_routes | Scan multiple routes and return status codes | | codmir_list_directory | List files and directories at a path | | codmir_connect / codmir_disconnect | Start/end an agent desktop session | | codmir_status | Check if the desktop agent is running |

Examples

Manage your to-do list:

You: What's on my to-do list?
AI: [Uses list_todo] → Shows 5 open tickets, 2 critical priority

You: Mark TKT-42 as done
AI: [Uses update_todo_status] → Done

Execute a task:

You: Fix the authentication bug in src/auth/login.ts
AI: [Uses execute_task] → Task queued, execution ID: exec_abc123

Create a ticket from conversation:

You: Create a ticket for the performance issue we just discussed
AI: [Uses create_ticket] → Created TKT-55: "Slow dashboard load on projects > 100 members"

Debug a production error:

You: What's happening with error err_abc123?
AI: [Uses get_error_context] → Stack trace, breadcrumbs, and 3 suggested files to investigate

Control the desktop:

You: Take a screenshot and click the "Deploy" button
AI: [Uses codmir_screenshot] → Screenshot captured
    [Uses codmir_click at (450, 320)] → Clicked Deploy button

Troubleshooting

"Not authenticated" error:

codmir login
# Or verify: cat ~/.codmir/credentials.json

MCP server not connecting: Restart your editor after updating the config. Test manually:

npx @codmir/mcp

Desktop tools not working: Make sure the Codmir desktop app is running. Check:

cat ~/.codmir/agent-port

Links

• Website
• Documentation
• GitHub

License

Apache-2.0