Skip to main content
Glama

Redbooth for Claude (MCP Server)

Connect Redbooth to Claude Desktop, Claude Code, Cursor, Antigravity, and other MCP clients in one click—no API keys or developer setup needed.

"What's overdue in the Website project?" · "Create a task for Anna to review the Q3 deck by Friday" · "Summarize the comments on task 12345 and mark it done"


Quick Install

Option A: Claude Desktop (1-Click Extension)

  1. Download redbooth.mcpb from the latest release.

  2. Double-click redbooth.mcpb (or drag it into Claude Desktop → Settings → Extensions) and click Install.

  3. Ask Claude anything about your Redbooth workspace (e.g. "List my Redbooth projects").

  4. On your first question, your browser will automatically open to Redbooth—click Allow and you're connected!


Option B: Claude Code (1 Command)

claude mcp add redbooth -- npx -y redbooth-mcp

Option C: Cursor / Antigravity / Claude Desktop JSON

Add this to your MCP settings (claude_desktop_config.json, .cursor/mcp.json, or Antigravity MCP settings):

{
  "mcpServers": {
    "redbooth": {
      "command": "npx",
      "args": ["-y", "redbooth-mcp"]
    }
  }
}

Related MCP server: redmine-mcp

How Sign-In & Privacy Work

  • Automatic browser sign-in: The first time you ask your assistant to read or update Redbooth, it opens your default browser to Redbooth's official OAuth screen. Click Allow, and your tokens are saved locally in ~/.config/redbooth-mcp/tokens.json (permissions 0600) and refreshed automatically.

  • Direct connection: A tiny, stateless Cloudflare Worker (worker/) handles only the initial OAuth handshake so you don't have to register your own Redbooth developer app. It stores zero data. All your projects, tasks, and comments flow directly between your computer and https://redbooth.com.

  • Switch accounts anytime: Ask Claude to "log out of Redbooth" or run npx -y redbooth-mcp logout.


Available Tools (21)

Tool

Description

Writes?

login / logout

Connect or disconnect your Redbooth account in the browser

get_me

Current user profile

list_organizations

Your organizations

list_users

Users (filter by org or project), to find assignee IDs

list_projects / get_project

Projects

create_project

Create a project

✏️

list_task_lists

Task lists in a project

create_task_list

Create a task list

✏️

list_tasks

Filter by project, list, assignee, status

get_task

Task details

create_task

Create a task (name, description, assignee, due date, urgent)

✏️

update_task

Change any task field, or move it to another list

✏️

complete_task

Mark a task resolved

✏️

list_subtasks / create_subtask / update_subtask

Checklist items

✏️ (create/update)

list_comments / add_comment

Task comments

✏️ (add)

redbooth_api_get

Read-only escape hatch for any API v3 GET path

Read-only mode: Enable the Read-only mode toggle in Claude Desktop's extension settings (or set REDBOOTH_READ_ONLY=true) to disable all ✏️ tools. Delete tools are intentionally excluded.


Advanced: Self-Hosting / Custom OAuth App

If you prefer not to use the default stateless OAuth broker, you can either deploy your own Cloudflare Worker (see worker/README.md) or register a personal Redbooth app at https://redbooth.com/oauth2/applications (Redirect URI http://localhost:8765/callback):

Variable

Purpose

REDBOOTH_READ_ONLY=true

Disable all write tools

REDBOOTH_AUTH_BROKER_URL

Point to your own Cloudflare Worker OAuth broker

REDBOOTH_CLIENT_ID / REDBOOTH_CLIENT_SECRET

Use your own Redbooth OAuth app directly (bypasses the broker)

REDBOOTH_ACCESS_TOKEN

Use a static access token

REDBOOTH_TOKEN_PATH

Custom token file location (default ~/.config/redbooth-mcp/tokens.json)

Development

git clone https://github.com/rmstougaard/redbooth-mcp.git && cd redbooth-mcp
npm install
npm run build
npm test
npm run inspect   # opens the MCP Inspector against the local build

License

MIT. This is an unofficial project and is not affiliated with Redbooth.

Available Tools

21 tools
add_commentAdd commentC

Post a comment on a Redbooth task.

Inputs: body (required), task_id (required).

complete_taskComplete taskB

Mark a Redbooth task as resolved (done).

Inputs: task_id (required).

create_projectCreate projectC

Create a new Redbooth project in an organization.

Inputs: name (required), organization_id (required), description.

create_subtaskCreate subtaskB

Add a subtask (checklist item) to a Redbooth task.

Inputs: name (required), task_id (required).

create_taskCreate taskA

Create a Redbooth task. Requires a project_id and a task_list_id (use list_task_lists to find one).

Inputs: name (required), project_id (required), task_list_id (required), due_on, +3 more.

create_task_listCreate task listC

Create a new task list in a Redbooth project.

Inputs: name (required), project_id (required).

get_meGet current userA
Read-only

Get the authenticated Redbooth user (useful to find your own user ID).

Inputs: no named parameters.

get_projectGet projectB
Read-only

Get details of a single Redbooth project.

Inputs: project_id (required).

get_taskGet taskA
Read-only

Get full details of a single Redbooth task.

Inputs: task_id (required).

list_commentsList commentsC
Read-only

List comments on a Redbooth task.

Inputs: task_id (required), limit.

list_organizationsList organizationsB
Read-only

List Redbooth organizations the current user belongs to.

Inputs: limit.

list_projectsList projectsA
Read-only

List Redbooth projects (workspaces) you have access to.

Inputs: limit, archived, organization_id.

list_subtasksList subtasksB
Read-only

List the subtasks (checklist items) of a Redbooth task.

Inputs: task_id (required), limit.

list_task_listsList task listsB
Read-only

List the task lists in a Redbooth project. A task must belong to a task list.

Inputs: project_id (required), limit, archived.

list_tasksList tasksA
Read-only

List Redbooth tasks. Filter by project, task list, assignee and/or status. Without filters returns tasks across all your projects.

Inputs: limit, status, project_id, task_list_id, +1 more.

list_usersList usersA
Read-only

List Redbooth users visible to you. Use this to find user IDs for assigning tasks. Optionally filter by organization or project.

Inputs: limit, project_id, organization_id.

loginLog in to RedboothA
Read-only

Sign in to your Redbooth account in the browser. Zero configuration required – opens your browser to Redbooth's authorization screen and waits for you to click Allow.

Inputs: wait_seconds.

logoutLog out of RedboothA
Read-only

Disconnect the current Redbooth account and remove locally stored OAuth tokens.

Inputs: no named parameters.

redbooth_api_getRaw Redbooth GETA
Read-only

Escape hatch: perform a read-only GET against any Redbooth API v3 path (e.g. path '/notes' with query {"project_id": 1}). Use only when no dedicated tool fits. Returns the raw JSON.

Inputs: path (required), query.

update_subtaskUpdate subtaskB

Rename a subtask and/or mark it resolved/unresolved.

Inputs: subtask_id (required), name, resolved.

update_taskUpdate taskA

Update fields on an existing Redbooth task. Only the provided fields are changed.

Inputs: task_id (required), name, due_on, status, +4 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 21 tools

    Disambiguation4/5

    Each tool targets a distinct resource+action (projects, tasks, subtasks, comments, users), so selection is mostly clear. The only mild overlap is complete_task vs update_task, but the description explicitly distinguishes the resolved-state shortcut.

    Naming Consistency4/5

    Nearly all tools follow a consistent snake_case verb_noun pattern (list_tasks, create_task, update_subtask). Minor deviations are login/logout (verb-only) and redbooth_api_get, which reverses the order and prefixes the domain.

    Tool Count4/5

    21 tools is on the heavier side but justified for a full project-management surface spanning auth, orgs, users, projects, task lists, tasks, subtasks, and comments. No obvious filler tools.

    Completeness3/5

    Core create/read/update flows exist for tasks, subtasks, and comments, but the surface lacks delete operations (tasks, subtasks, projects, comments) and update_project/update_task_list, leaving notable lifecycle gaps. The read-only escape hatch helps but cannot cover writes.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Claude and other MCP clients to log, update, and delete FreshBooks time entries, run and stop timers, and pull summaries of billable and unbilled hours by day, week, client, project, or service, with OAuth-based sign-in and per-user token storage.
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Enables Claude to read and, when explicitly enabled, update projects, issues, time entries, versions, wiki pages, and supported helpdesk, agile, CRM, and checklist data through the Redmine REST API. It runs read-only by default with separate HTTP and Redmine-permission safeguards.
      17
      1
      Apache 2.0
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables MCP-capable clients to browse, search, and manage Basecamp 3 projects, todolists, todos, messages, campfires, card tables, inbox forwards, documents, uploads, comments, events, and webhooks through OAuth-authenticated API calls, including downloading attachments as readable content.
      -