@loikka/bloom-growth-mcp

The first MCP (Model Context Protocol) server for Bloom Growth — the leading EOS/Traction implementation platform. This server gives Claude (and any MCP-compatible AI client) direct access to your EOS data: scorecards, rocks, to-dos, issues, headlines, and L10 meetings.

Quick Start

Option 1: npx (recommended)

npx @loikka/bloom-growth-mcp

Option 2: Install globally

npm install -g @loikka/bloom-growth-mcp
bloom-growth-mcp

Option 3: Clone and build

git clone https://github.com/loikka/bloom-growth-mcp.git
cd bloom-growth-mcp
npm install
npm run build
npm start

Configuration

The server requires your Bloom Growth credentials as environment variables:

export BLOOM_USERNAME="[email protected]"
export BLOOM_PASSWORD="your-password"

Or create a .env file (see .env.example).

Claude Desktop / Cowork Configuration

Add to your MCP settings (e.g., claude_desktop_config.json):

{
  "mcpServers": {
    "bloom-growth": {
      "command": "npx",
      "args": ["@loikka/bloom-growth-mcp"],
      "env": {
        "BLOOM_USERNAME": "[email protected]",
        "BLOOM_PASSWORD": "your-password"
      }
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | bloom_get_scorecard | Get scorecard for current user, specific user, or meeting | | bloom_list_measurables | List all measurables (KPIs) for a user | | bloom_get_scores | Get score history for a specific measurable | | bloom_write_score | Write a score value for a measurable and week | | bloom_list_rocks | List quarterly rocks (90-day goals) | | bloom_update_rock | Update rock status (OnTrack/OffTrack/Complete) | | bloom_list_todos | List to-dos from a meeting | | bloom_create_todo | Create a new to-do | | bloom_list_issues | List IDS issues | | bloom_create_issue | Create a new issue | | bloom_complete_issue | Mark an issue as solved | | bloom_list_headlines | List headlines from a meeting | | bloom_list_meetings | List all L10 meetings | | bloom_search | Search across all Bloom data |

Example Usage in Claude

"Show me my scorecard for this week"

"What are my current rocks and their status?"

"Enter 5 new customers into the 'New Logos' measurable for this week"

"Create a to-do: Review Q3 marketing budget — in our Leadership Team meeting"

"What issues are open in our weekly L10?"

How It Works

The server authenticates with Bloom Growth using your credentials (username/password → Bearer token). The token is cached for 14 days and refreshed automatically. All communication with the MCP client uses the stdio transport (JSON-RPC over stdin/stdout).

API Reference

This server wraps the Bloom Growth REST API.

EOS Concepts Covered

• Scorecard — Weekly measurables (KPIs) with targets and actual values
• Rocks — 90-day priorities (quarterly goals)
• To-Dos — 7-day action items from L10 meetings
• Issues — IDS (Identify, Discuss, Solve) list
• Headlines — Good news and FYI items shared in L10
• L10 Meetings — Weekly leadership team meetings

Development

npm install
npm run dev      # Watch mode (recompiles on change)
npm run build    # One-time build
npm start        # Run the server

License

MIT — Loikka Solutions Oy