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

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."

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.