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+

modusop-mcp

Quick Install