@codmir/mcp

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