Runn MCP Server

Standalone MCP server for the Runn API with simple reporting helpers.

Local serverstdioPython

What is the Runn MCP Server?

Standalone MCP server for the Runn API with simple reporting helpers.

Configuration and credentials

  • Python 3.10+ - Runn API key (RUNN_API_KEY)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_projectsreturns {id, name} pairs.
list_peoplereturns {id, name, email} by default (set full=true for raw objects).
billable_hoursaggregates billable hours grouped by project/person/month.
list_clientslist clients (raw API objects).
list_assignmentslist assignments (raw API objects).
list_assignments_by_personassignments for a person, optional date range.
list_assignments_by_projectassignments for a project, optional date range.
list_assignments_by_roleassignments for a role, optional date range.
list_assignments_by_teamassignments for a team’s people, optional date range.
list_actualslist actuals (raw API objects).
list_actuals_by_date_rangeactuals in a date range, optional person/project filters.
list_actuals_by_personactuals for a person, optional date range.
list_actuals_by_projectactuals for a project, optional date range.
list_actuals_by_roleactuals for a role, optional date range.
list_actuals_by_teamactuals for a team’s people, optional date range.
list_roleslist roles (raw API objects).
list_roles_by_personroles that include a person.
list_skillslist skills (raw API objects).
list_skills_by_personskills for a person with levels + names.
list_teamslist teams (raw API objects).
list_people_by_teampeople in a team (optionally include archived).
list_people_by_skillpeople who have a skill (optional min level).
list_people_by_tagpeople with a tag (by id or name).
list_people_by_managerpeople managed by a manager id.
list_rate_cardslist rate cards (raw API objects).
list_rate_cards_by_projectrate cards that include a project.
runn_requestcall any Runn API endpoint (GET/POST/PATCH/PUT/DELETE).

How to install the Runn MCP Server

{
  "mcpServers": {
    "runn": {
      "command": "/path/to/python3",
      "args": [
        "/path/to/mcp_runn_server.py",
        "--transport",
        "stdio"
      ],
      "env": {
        "RUNN_API_KEY": "YOUR_RUNN_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Python 3.10+ - Runn API key (RUNN_API_KEY)
VariableDescriptionRequired
RUNN_API_KEYDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Runn to list projects.”
  • “Use Runn to list people.”
  • “Use Runn to billable hours.”

Frequently asked questions

Standalone MCP server for the Runn API with simple reporting helpers. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.