MCP Workboard

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/crunchtools-workboard

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

18 read · 9 write · 0 delete

Secrets

None asked for

Install scripts

None found

Runs as

Python package

Tools (27)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• workboard_auth_result_toolread-only

  Report the outcome of the most recent authorization redirect.

• workboard_auth_start_tool

  Begin browser authorization and return the URL for the user to approve. Open the returned URL. The user approves there, WorkBoard redirects back to this server, and the tokens are stored automatically -- nothing is copied back by hand. Then call workboard_auth_status_tool to confirm. Requires OAuth mode and WORKBOARD_OAUTH_REDIRECT_URI.

• workboard_auth_status_toolread-only

  Report whether this server currently holds a usable WorkBoard credential. Call this first. It says which auth mode is active, where tokens are stored, whether one exists, and verifies it with GET /user. If it is not usable, it says which tool fixes it.

• workboard_create_activity_tool

  Create a new action item (card) on a WorkBoard workstream. State must be "next", "doing", "done", or "pause". Priority must be "low", "med", or "high". Effort must be "easy", "medium", or "huge". Args: ai_description: Description of the action item — shown as the card title (required) ai_note: Notes or body text for the action item (optional) ai_workstream: Workstream ID to place the action item in (optional) ai_team: Team ID to associate with (optional) ai_owner: Owner user ID or email (optional) ai_state: Initial state: next, doing, done, or pause (optional) ai_…

• workboard_create_objective_tool

  Create a new objective with optional key results. Creates Team or Individual objectives. Requires an OAuth token whose account has the Data-Admin role; instant JWT tokens cannot create objectives. The API has no update or delete for objectives — those are UI-only. Team objectives must be tied to a team: pass ``team`` (a team ID from workboard_get_teams_tool). Provide the objective name, owner, dates, and optionally key results with targets. Each key result has a name and optional start_value, target_value, and unit_type (e.g. "Number", "Currency", "Percent"). Args: name: Objective name …

• workboard_create_user_tool

  Create a new WorkBoard user (requires Data-Admin role). Args: first_name: User's first name last_name: User's last name email: User's email address designation: User's job title or designation Returns: Created user details

• workboard_create_workstream_tool

  Create a new workstream for a team. Requires team manager or co-manager permissions. Args: ws_name: Name of the workstream team_id: Parent team ID ws_owner: User ID of the team manager or co-manager ws_objective: Optional descriptive narrative or objective statement Returns: Created workstream details

• workboard_get_activity_toolread-only

  Get a single WorkBoard action item by its ID. Args: activity_id: Action item ID (positive integer) Returns: Action item details including description, state, owner, due date, comments, sub-actions, and attached files

• workboard_get_my_key_results_toolread-only

  List all key results (metrics) the current user owns or has access to. Use this to find metric IDs and see current progress before updating with workboard_update_key_result_tool. Returns metric names, current values, targets, and IDs. By default, only shows current year key results. Set include_prior_years=True to see key results from previous years. Args: include_prior_years: If True, include key results from prior years. Defaults to False (current year only). Returns: List of key results with IDs, names, values, and targets

• workboard_get_my_objectives_toolread-only

  Get the current authenticated user's objectives with key results. This is the RECOMMENDED tool when users ask about "my objectives" or "my OKRs". It automatically determines the current user and discovers their objectives from their key results — no IDs needed. Args: objective_ids: Optional list of specific objective IDs to fetch (at most 25). If not provided, objectives are auto-discovered from the user's key results. Returns: List of objectives with their key results (metrics)

• workboard_get_objective_details_toolread-only

  Get full details for a single objective including all its key results. Returns the objective name, progress, status, dates, and all key results (metrics) with their targets, progress, and update schedules. Use workboard_get_user_tool (no arguments) to find the current user's ID. Args: user_id: User ID (positive integer). Get this from workboard_get_user_tool. objective_id: Objective ID (positive integer). Returns: Full objective details with key results (metrics)

• workboard_get_objectives_toolread-only

  Get objectives owned by a WorkBoard user by their user ID. Returns all objectives the user owns, with full pagination. Also exposes ``workstreams`` and ``status_color`` fields on each objective when present. Use workboard_get_user_tool (no arguments) to find the current user's ID. Use workboard_get_team_members_tool to resolve a name or email to a user ID. Args: user_id: User ID (positive integer). Get this from workboard_get_user_tool. Returns: List of objectives owned by the user, including all key results

• workboard_get_team_members_toolread-only

  Get all members of a WorkBoard team, including their user IDs and emails. Use this to resolve a person's name or email to their WorkBoard user_id. Combine with workboard_get_objectives_tool(user_id) to fetch their OKRs. Args: team_id: The WorkBoard team ID (get from workboard_get_teams_tool) Returns: team_id, team_name, and members list with user_id, full_name, email, team_role

• workboard_get_team_objectives_toolread-only

  Get a team's objectives whose dates overlap a window, past quarters included. Use this for quarterly OKR reviews or snapshots, e.g. Q1 after March 31. Objectives on sub-teams are not included. Slow: it reads every objective you can see, which takes about a minute. Use workboard_get_teams_tool to find team IDs. Args: team_id: Team ID (positive integer) start_date: Window start, YYYY-MM-DD (e.g. the first day of a quarter) end_date: Window end, YYYY-MM-DD, inclusive (e.g. the last day of a quarter) Returns: Objectives with progress, owner, status color, dates, and key results

• workboard_get_team_workstreams_toolread-only

  Get all workstreams belonging to a specific team. Use workboard_get_teams_tool to find team IDs first. Args: team_id: Team ID (positive integer) Returns: Team info with list of workstreams

Signals

Stars

1

Forks

2

Open issues

0

Weekly downloads

762

Last commit

Oct 21, 2026 (8 days ago)

Last release

Oct 20, 2026 (8 days ago)

Last package publish

Oct 20, 2026 (8 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.crunchtools/workboard

Version

0.6.1

Auth

No auth

Packages

pypi mcp-workboard-crunchtools

License

AGPL-3.0

Repository

github.com/crunchtools/mcp-workboard

First seen

Oct 24, 2026

Last checked

Oct 25, 2026

Source

Official MCP Registrygithub-graphql