# Roadmunk MCP by usefulapi

> Roadmunk MCP by usefulapi is an MCP server. Read roadmaps, items and milestones; create and update items and milestones in Roadmunk. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/roadmunk/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/roadmunk
- **MCP Registry name:** io.usefulapi/roadmunk
- **Listing updated:** 2026-11-13

## About

Read roadmaps, items and milestones; create and update items and milestones in Roadmunk.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http roadmunk https://roadmunk.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://roadmunk.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "roadmunk": {
      "url": "https://roadmunk.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "roadmunk": {
      "type": "http",
      "url": "https://roadmunk.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "roadmunk": {
      "serverUrl": "https://roadmunk.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "roadmunk": {
      "type": "http",
      "url": "https://roadmunk.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `roadmunk_get_account`: Get the Roadmunk account: company name, billing contact and plan (package limits). Good first call to confirm the connection. GraphQL: account.
- `roadmunk_list_users`: List users of the account with role and last login. Optionally filter by role or a search string. GraphQL: users.
- `roadmunk_get_user`: Get one user by id. GraphQL: user(userID).
- `roadmunk_list_roadmaps`: List roadmaps with title and last update (milliseconds since Unix epoch). Optionally search by title. Archived roadmaps are left out unless asked. GraphQL: roadmaps.
- `roadmunk_get_roadmap`: Get one roadmap by id, with its first 50 fields, items and milestones (hasMore says if more exist). Use roadmunk_list_items / roadmunk_list_milestones for more. GraphQL: roadmap(roadmapID).
- `roadmunk_list_items`: Search roadmap items by text, optionally inside one roadmap. An item has dates or a bucket (time period), not both. GraphQL: items.
- `roadmunk_get_item`: Get one item by id with its field values, key dates, parent and sub-items (first 50 of each; if hasMore is true, pass a higher nested_offset to read the next 50 of every list). GraphQL: item(itemID).
- `roadmunk_list_milestones`: Search milestones by text, optionally inside one roadmap. A milestone has one date. GraphQL: milestones.
- `roadmunk_get_milestone`: Get one milestone by id with its field values (first 50; if hasMore is true, pass a higher fields_offset). GraphQL: milestone(milestoneID).
- `roadmunk_get_field`: Get one roadmap or account field by id: name, type and, for list fields, the allowed values (first 100; if hasMore is true, pass a higher values_offset); for number fields the format. GraphQL: field(fieldID).
- `roadmunk_create_item`: WRITE: create a new item on a roadmap. Changes live data (Roadmunk has no test environment). Give dates OR a bucket, not both. GraphQL: createItem.
- `roadmunk_update_item`: WRITE: change an item. Only the arguments you pass change. Changes live data. GraphQL: updateItem.
- `roadmunk_create_milestone`: WRITE: create a milestone on a roadmap. Changes live data. GraphQL: createMilestone.
- `roadmunk_update_milestone`: WRITE: change a milestone. Only the arguments you pass change. Changes live data. GraphQL: updateMilestone.

## FAQ

### How do I add Roadmunk MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http roadmunk https://roadmunk.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/roadmunk-mcp-by-usefulapi
