Redbooth MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Redbooth MCP Server What's overdue in the Website project?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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)
Download
redbooth.mcpbfrom the latest release.Double-click
redbooth.mcpb(or drag it into Claude Desktop → Settings → Extensions) and click Install.Ask Claude anything about your Redbooth workspace (e.g. "List my Redbooth projects").
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-mcpOption 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(permissions0600) 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 andhttps://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? |
| Connect or disconnect your Redbooth account in the browser | |
| Current user profile | |
| Your organizations | |
| Users (filter by org or project), to find assignee IDs | |
| Projects | |
| Create a project | ✏️ |
| Task lists in a project | |
| Create a task list | ✏️ |
| Filter by project, list, assignee, status | |
| Task details | |
| Create a task (name, description, assignee, due date, urgent) | ✏️ |
| Change any task field, or move it to another list | ✏️ |
| Mark a task resolved | ✏️ |
| Checklist items | ✏️ (create/update) |
| Task comments | ✏️ (add) |
| 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 |
| Disable all write tools |
| Point to your own Cloudflare Worker OAuth broker |
| Use your own Redbooth OAuth app directly (bypasses the broker) |
| Use a static access token |
| Custom token file location (default |
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 buildLicense
MIT. This is an unofficial project and is not affiliated with Redbooth.
Available Tools
21 toolsadd_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 userARead-only
Get the authenticated Redbooth user (useful to find your own user ID).
Inputs: no named parameters.
get_projectGet projectBRead-only
Get details of a single Redbooth project.
Inputs: project_id (required).
get_taskGet taskARead-only
Get full details of a single Redbooth task.
Inputs: task_id (required).
list_commentsList commentsCRead-only
List comments on a Redbooth task.
Inputs: task_id (required), limit.
list_organizationsList organizationsBRead-only
List Redbooth organizations the current user belongs to.
Inputs: limit.
list_projectsList projectsARead-only
List Redbooth projects (workspaces) you have access to.
Inputs: limit, archived, organization_id.
list_subtasksList subtasksBRead-only
List the subtasks (checklist items) of a Redbooth task.
Inputs: task_id (required), limit.
list_task_listsList task listsBRead-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 tasksARead-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 usersARead-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 RedboothARead-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 RedboothARead-only
Disconnect the current Redbooth account and remove locally stored OAuth tokens.
Inputs: no named parameters.
redbooth_api_getRaw Redbooth GETARead-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
Scored across 21 tools
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.
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.
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.
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
Related MCP Connectors
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Headless task management for bots, apps and AI agents. Remote MCP server, OAuth or access token.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables 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
- AlicenseCqualityBmaintenanceEnables 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.171Apache 2.0
- FlicenseNot gradedqualityAmaintenanceEnables 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.-
- FlicenseNot gradedqualityAmaintenanceEnables MCP-capable clients to read and manage Basecamp 3 projects, todos, messages, card tables, documents, uploads, and search through OAuth-authenticated API calls.-