Docs

ProWoDo MCP Connector — Documentation

Setup, tools reference and troubleshooting for the ProWoDo MCP connector: manage tasks, sprints, backlog and daily planning from Claude and other AI assistants.

ProWoDo exposes a remote MCP server that lets AI assistants like Claude read and update your tasks, projects, sprints and backlog directly from chat — no copy-paste, no context switching.

  • Server URL: https://mcp.prowodo.com/mcp/
  • Authentication: OAuth 2.0 (no API token to paste)
  • Transport: Streamable HTTP

Setup

From the Claude connectors directory

  1. In Claude, open Settings → Connectors.
  2. Search for ProWoDo in the directory and click Connect.
  3. You'll be redirected to ProWoDo to sign in and authorize access. Approve the requested scopes.
  4. Done — ask Claude about your tasks.

Manual setup (custom connector)

If you prefer to add it manually, or you use Claude Code:

  1. Open Settings → Connectors → Add custom connector.
  2. Enter the server URL: https://mcp.prowodo.com/mcp/
  3. Claude starts the OAuth flow automatically (discovery via /.well-known/oauth-protected-resource). Sign in to ProWoDo and authorize.

You need a ProWoDo account first — create one for free at app.prowodo.com.

Authentication & permissions

The connector uses OAuth 2.0. ProWoDo never asks you to paste a token into Claude. Access is granted with explicit scopes:

ScopeGrants
tasks:readRead tasks, projects, sprints, tags
tasks:writeCreate, update, complete, reorganize tasks
assignments:writeAssign / unassign teammates
comments:writeWrite comments / resume entries

The assistant only ever accesses your own data (the companies you belong to). You can review and revoke the connection at any time from your ProWoDo profile, or by removing the connector in Claude's settings.

Read-only tools are annotated (readOnlyHint) so they run without extra confirmation; tools that change or delete data are annotated (destructiveHint) so Claude asks for your approval first.

Tools reference

The server is tool-only (no MCP resources or prompts). Tools are grouped by entity. R = read-only, W = writes/changes data.

Tasks

ToolTypeWhat it does
List TasksRList/search tasks (filter by project, status, sprint, text…)
Get TaskRRetrieve a single task with full detail
Create TaskWCreate a task (title, project, priority, story points…)
Update Task / Partially Update TaskWEdit a task (status, progress, priority, etc.)
Delete TaskWSoft-delete a task
Add Tag / Remove TagWAdd or remove a tag on a task
Assign User to Task / Unassign User from TaskWManage task assignees
Increase Depth / Decrease DepthWNest / un-nest a task as a sub-task
Move Up / Move DownWReorder a task within its level
Relate to TaskWMove a task relative to another
Move to ProjectWMove a task to another project
Move to SprintWAssign a task to a sprint
Reorder Children / Reorder Root TasksWNormalize ordering at a level

Projects

ToolTypeWhat it does
List Projects / Get ProjectRList projects of a company / retrieve one
Create ProjectWCreate a project in a company
Update Project / Partially Update ProjectWEdit a project
Delete ProjectWSoft-delete a project

Sprints & lanes (Scrum)

ToolTypeWhat it does
List Sprints / Get SprintRList a project's sprints / retrieve one
Create SprintWCreate a sprint
Update Sprint / Partially Update SprintWEdit a sprint
Delete SprintWSoft-delete a sprint
Start Sprint / Close SprintWBegin / end a sprint
List Sprint Lanes / Get Sprint LaneRRead sprint board lanes
Move Sprint LaneWReorder a board lane

Companies, users & tags

ToolTypeWhat it does
List Companies / Get CompanyRList your companies / retrieve one
Create CompanyWCreate a company
List Users / Get UserRList company members / retrieve one
List Task Tags / Get Task TagRRead tags
Create / Update / Partially Update / Delete Task TagWManage tags

Daily Resume

ToolTypeWhat it does
List Resume Entries / Get Resume EntryRRead daily resume entries
Create / Update / Partially Update / Delete Resume EntryWManage daily resume entries
ToolTypeWhat it does
List Notes / Get NoteRList a company's notes (filter by project, title, visibility, tag, creation or update date; sort by title, creation or update date) / retrieve one
Search NotesRFull-text search in note titles and content. Private notes of other people are never returned
Search KnowledgeROne full-text search across task titles and descriptions, task comments and notes; best matches first, with a short snippet. Support tickets are not included. Private notes of other people are never returned
Create / Update / Partially Update NoteWWrite notes in markdown; a note can link back to the task it came from, and can be shared with the company (default) or kept private to you
Delete NoteWMove a note to the trash. It is not removed for good: you can bring it back
List Trashed Notes / Restore NoteR / WSee the notes in the trash and restore one. Permanent deletion is only possible from the app, never over MCP
Note History / Revert NoteR / WList the saved versions of a note and go back to an earlier one (the revert is saved as a new version)
Note LinksRFollow the connections of a note: the [[wikilinks]] it contains and the notes that link to it

Rhythm (weekly focus)

ToolTypeWhat it does
Get my weekly rhythmRYour rhythm: the free text you wrote, its items (focus per weekday, goals for the whole week, deadlines) and whether the text changed since it was last turned into items
Plan my dayRToday's plan: the tasks in focus, the deadlines that can't wait (overdue or due within 3 days), a short list of the rest and anything to fix. Tasks come already ordered by priority
List Rhythm ItemsRRead your items, filtered by scope or weekday
Write my rhythm textWReplace the free text of your rhythm, for example "Monday: client work and thesis"
Create / Update / Delete Rhythm ItemWManage items by hand. Items derived from the text are only dismissed when deleted, so they are not recreated for the same phrase
Mark Rhythm as InterpretedWRecord that the text has been turned into items

Help & release notes

ToolTypeWhat it does
Get a guide to the toolsRA short guide to the tools, by area, for when the assistant isn't sure which one to use
Get Recent Release NotesRThe latest ProWoDo release notes, newest first. Ask what changed since the version you know

Example prompts

  • "Show me my open ProWoDo tasks that aren't done yet."
  • "Create a task in project X: 'Write release notes', priority high, 3 story points."
  • "Mark task #1234 as done and set its progress to 100%."
  • "Move the auth bug into the current sprint and assign it to me."
  • "Give me a sprint-planning summary: tasks grouped by priority with story points."
  • "Where did we talk about the Stripe webhook retries? Search tasks, comments and notes."
  • "Review my notes tagged inbox from the last month and suggest what to do with each."
  • "Plan my day."
  • "What changed in ProWoDo since version 1.24?"

Troubleshooting

"Couldn't reach the MCP server." Check the URL is exactly https://mcp.prowodo.com/mcp/ (HTTPS, trailing slash). The server is publicly reachable; if it still fails, retry the OAuth flow.

The authorization loops or fails. Make sure you're logged into the correct ProWoDo account in the browser that opens for OAuth. Clear the pending connection in Claude's settings and add it again.

Claude keeps asking for confirmation on every call. That's expected for tools that change data (annotated destructiveHint). Read-only tools (list/get) run without confirmation.

A tool returns "not found" or empty results. You only see data for companies you're a member of. Confirm you're connected with the right account and that the project/company exists for that user.

I want to revoke access. Remove the connector in Claude's Settings → Connectors, and/or revoke the authorization from your ProWoDo profile. Access stops immediately.

Support

Questions or issues? Email hello@prowodo.com.