ModusOp MCP Server

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

Tools

| Tool | Description | |------|-------------| | search_projects | Search projects by name | | search_clients | Search clients by name | | get_client_context | Get project, client, and retainer info | | get_tasks | List tasks for a project (filter by status) | | create_task | Create a new task | | start_timer | Start a timer on a task | | stop_timer | Stop the running timer | | get_retainer_status | Check retainer hours used/remaining |

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

| Environment Variable | Default | Description | |---------------------|---------|-------------| | MODUSOP_API_TOKEN | (required) | Your ModusOp API token | | MODUSOP_API_URL | https://modusop.app/api/v1 | API base URL |

Requirements

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