README.md
A secure MCP server for WorkBoard OKR and strategy execution platform.
MCP WorkBoard CrunchTools
A secure MCP (Model Context Protocol) server for WorkBoard OKR and strategy execution platform.
Overview
This MCP server is designed to be:
- Secure by default - Comprehensive threat modeling, input validation, and token protection
- No third-party services - Runs locally via stdio, your API token never leaves your machine
- Cross-platform - Works on Linux, macOS, and Windows
- Automatically updated - GitHub Actions monitor for CVEs and update dependencies
- Containerized - Available at
quay.io/crunchtools/mcp-workboardbuilt on Hummingbird Python base image
Naming Convention
| Component | Name |
|---|---|
| GitHub repo | crunchtools/mcp-workboard |
| Container | quay.io/crunchtools/mcp-workboard |
| Python package (PyPI) | mcp-workboard-crunchtools |
| CLI command | mcp-workboard-crunchtools |
| Module import | mcp_workboard_crunchtools |
Why Hummingbird?
The container image is built on the Hummingbird Python base image from Project Hummingbird, which provides:
- Minimal CVE exposure - Built with a minimal package set, dramatically reducing attack surface
- Regular updates - Security patches applied promptly
- Optimized for Python - Pre-configured with uv package manager
- Production-ready - Proper signal handling and non-root user defaults
Features
User Management (4 tools)
workboard_get_user- Get a user by ID or the current authenticated userworkboard_list_users- List all users (Data-Admin role required)workboard_create_user- Create a new user (Data-Admin role required)workboard_update_user- Update an existing user
Objective Management (4 tools)
workboard_get_objectives- Get objectives associated with a user (API capped at 15)workboard_get_objective_details- Get details for a specific objective with key resultsworkboard_get_my_objectives- Get the current user's owned objectives by ID (recommended)workboard_create_objective- Create a new objective with key results (Data-Admin required)
Key Result Management (2 tools)
workboard_get_my_key_results- List current user's key results with metric IDs and progressworkboard_update_key_result- Update key result progress for weekly OKR check-ins
Workstream Management (5 tools)
workboard_get_workstreams- Get team workstreams accessible to the authenticated userworkboard_get_workstream_activities- Get workstream details with all action itemsworkboard_get_team_workstreams- Get all workstreams belonging to a specific teamworkboard_create_workstream- Create a new workstream for a teamworkboard_update_workstream- Update workstream properties (name, dates, pace, health, priority)
Installation
With uvx (Recommended)
uvx mcp-workboard-crunchtools
With pip
pip install mcp-workboard-crunchtools
With Container
podman run -e WORKBOARD_API_TOKEN=your_token \
quay.io/crunchtools/mcp-workboard
Configuration
Getting a WorkBoard API Token
- Log in to your WorkBoard instance
- Navigate to Admin Settings > API Configuration
- Generate a JWT API token
- Copy the token immediately - store it securely
Add to Claude Code
claude mcp add mcp-workboard \
--env WORKBOARD_API_TOKEN=your_token_here \
-- uvx mcp-workboard-crunchtools
Or for the container version:
claude mcp add mcp-workboard \
--env WORKBOARD_API_TOKEN=your_token_here \
-- podman run -i --rm -e WORKBOARD_API_TOKEN quay.io/crunchtools/mcp-workboard
Usage Examples
Get Current User
User: Who am I in WorkBoard?
Assistant: [calls workboard_get_user with no args]
List All Users
User: List all WorkBoard users
Assistant: [calls workboard_list_users]
Get User Objectives
User: Show me objectives for user 12345
Assistant: [calls workboard_get_objectives with user_id=12345]
Get Objective Details
User: Get details on objective 67890 for user 12345
Assistant: [calls workboard_get_objective_details with user_id=12345, objective_id=67890]
Get My Objectives
User: Show me my objectives (IDs: 2900058, 2900075, 2901770)
Assistant: [calls workboard_get_my_objectives with objective_ids=[2900058, 2900075, 2901770]]
List My Key Results
User: Show me my key results
Assistant: [calls workboard_get_my_key_results]
Update Key Result Progress
User: Update key result 12345 to 75
Assistant: [calls workboard_update_key_result with metric_id=12345, value="75"]
Create an Objective
User: Create an objective called "Increase retention" owned by user@example.com
Assistant: [calls workboard_create_objective with name, owner, dates, and option
Tools (15)
workboard_get_userGet a user by ID or the current authenticated user.workboard_list_usersList all users (Data-Admin role required).workboard_create_userCreate a new user (Data-Admin role required).workboard_update_userUpdate an existing user.workboard_get_objectivesGet objectives associated with a user.workboard_get_objective_detailsGet details for a specific objective with key results.workboard_get_my_objectivesGet the current user's owned objectives by ID.workboard_create_objectiveCreate a new objective with key results (Data-Admin required).workboard_get_my_key_resultsList current user's key results with metric IDs and progress.workboard_update_key_resultUpdate key result progress for weekly OKR check-ins.workboard_get_workstreamsGet team workstreams accessible to the authenticated user.workboard_get_workstream_activitiesGet workstream details with all action items.workboard_get_team_workstreamsGet all workstreams belonging to a specific team.workboard_create_workstreamCreate a new workstream for a team.workboard_update_workstreamUpdate workstream properties.Environment Variables
WORKBOARD_API_TOKENrequiredJWT API token generated from WorkBoard Admin SettingsConfiguration
claude_desktop_config.json
{"mcpServers": {"workboard": {"command": "uvx", "args": ["mcp-workboard-crunchtools"], "env": {"WORKBOARD_API_TOKEN": "your_token_here"}}}}Try it
→Who am I in WorkBoard?
→Show me my objectives.
→Update key result 12345 to 75.
→List all WorkBoard users.
→Get details on objective 67890 for user 12345.