MCP Workboard MCP server

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 - 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-workboard built on Hummingbird Python base image

Naming Convention

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)

• workboardgetuser - Get a user by ID or the current authenticated user
• workboardlistusers - List all users (Data-Admin role required)
• workboardcreateuser - Create a new user (Data-Admin role required)
• workboardupdateuser - Update an existing user

Objective Management (4 tools)

• workboardgetobjectives - Get objectives associated with a user (API capped at 15)
• workboardgetobjective_details - Get details for a specific objective with key results
• workboardgetmy_objectives - Get the current user's owned objectives by ID (recommended)
• workboardcreateobjective - Create a new objective with key results (Data-Admin required)

Key Result Management (2 tools)

• workboardgetmykeyresults - List current user's key results with metric IDs and progress
• workboardupdatekey_result - Update key result progress for weekly OKR check-ins

Workstream Management (5 tools)

• workboardgetworkstreams - Get team workstreams accessible to the authenticated user
• workboardgetworkstream_activities - Get workstream details with all action items
• workboardgetteam_workstreams - Get all workstreams belonging to a specific team
• workboardcreateworkstream - Create a new workstream for a team
• workboardupdateworkstream - 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

1. Log in to your WorkBoard instance
2. Navigate to Admin Settings > API Configuration
3. Generate a JWT API token
4. 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

Shortened. The full README is on GitHub.