runn-mcp-server

MCP server for Runn — resource planning and utilization tracking.

Tools

Tool	Description
get_team_utilization	Actual utilization % from timesheet data, resolved team/role names, team-level summaries (avg utilization, headcount)
get_project_overview	Projects with budget vs actual spend, resolved client/team/people names, pricing model labels. Filter by status: active (default), tentative, archived, or all
get_capacity_forecast	Weekly capacity buckets with leave integration, resolved team names, availability windows
get_person_details	Full profile with resolved skill names, role names, team name, current assignments
search_resources	Search people/projects/clients by name

Installation

No install needed — runs directly via npx:

npx -y github:rocketsciencegg/runn-mcp-server

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "runn": {
      "command": "npx",
      "args": ["-y", "github:rocketsciencegg/runn-mcp-server#v2.1.0"],
      "env": {
        "RUNN_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "runn": {
      "command": "npx",
      "args": ["-y", "github:rocketsciencegg/runn-mcp-server#v2.1.0"],
      "env": {
        "RUNN_API_KEY": "${RUNN_API_KEY}"
      }
    }
  }
}

Environment Variables

Variable	Description
RUNN_API_KEY	Your Runn API key
PORT	(Optional) Set to run as an HTTP Streamable server instead of stdio

Development

git clone https://github.com/rocketsciencegg/runn-mcp-server.git
cd runn-mcp-server
npm install
npm run build
npm test

Integration tests

Integration tests run against the live Runn API and require RUNN_API_KEY:

just integration

These are not run in CI (no API key available).

License

MIT