ModusOp MCP Server

MCP server for ModusOp — gives AI assistants access to your client context, tasks, time tracking, and retainer budgets.

Tools

Required Token Scopes

When you create an API token in ModusOp → Settings → API Tokens, grant these scopes:

• read — needed for search_projects, search_clients, get_client_context, get_tasks, get_retainer_status, and the current-timer check used by stop_timer.
• write — needed for create_task, start_timer, and stop_timer.

A token missing the required scope returns HTTP 403 with Insufficient permissions for this action.. Most setups want both scopes.

Setup

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "modusop": {
      "command": "npx",
      "args": ["@modusop/mcp-server"],
      "env": {
        "MODUSOP_API_TOKEN": "your-api-token"
      }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "modusop": {
      "command": "npx",
      "args": ["@modusop/mcp-server"],
      "env": {
        "MODUSOP_API_TOKEN": "your-api-token"
      }
    }
  }
}

Claude Code

claude mcp add modusop -- npx @modusop/mcp-server

Set MODUSOP_API_TOKEN in your environment.

Configuration

Requirements

• A ModusOp account with an API token
• Node.js 18+