Geekbot MCP

A server that bridges Anthropic's Claude AI with Geekbot's standup management tools, allowing users to access and utilize Geekbot data within Claude conversations.

Visit Website
Geekbot MCP

Introduction

Geekbot MCP

Geekbot MCP Logo Python 3.10+ License: MIT

Geekbot MCP server acts as a bridge between Anthropic's Claude AI and Geekbot's powerful standup, polls and survey management tools. Provides access to your Geekbot data and a set of tools to seamlessly use them in your Claude AI conversations.

Features

  • Standup Information: Fetch all your standups in Geekbot
  • Report Retrieval: Get standup reports with filtering options
  • Members Information: Fetch all your team members in Geekbot

Installation

Download the uv package manager

curl -LsSf https://astral.sh/uv/install.sh | sh

Further instructions can be found here

git clone https://github.com/geekbot-com/geekbot-mcp.git
cd geekbot-mcp
uv tool install --editable .

Configuration

Before using Geekbot MCP, you need to set up your Geekbot API key:

You can obtain your Geekbot API key from here.

Configure the mcp server in your claude_desktop_config.json

{
  "globalShortcut": "",
  "mcpServers": {
    "geekbot-mcp": {
      "command": "<path-to-your-uv-executable>",
      "args": [
        "tool",
        "run",
        "geekbot-mcp"
      ],
      "env": {
        "GB_API_KEY": "<your-geekbot-api-key>"
      }
    }
  }
}

To find the path to your uv executable, you can run which uv in your terminal. You can find more information about the configuration here

Available Tools

list_standups

Retrieves a list of all standups from your Geekbot workspace.

The response is in a plain text format.

<Standups>
***Standup: 1 - Infrastructure Changelog***
id: 1
name: Infrastructure Changelog
channel: team-infrastructure
time: 10:00:00
timezone: user_local
questions:

- text: What changed in the infrastructure today?
  answer_type: text
  is_random: False



***Standup: 2 - Meeting Agenda (TOC Beta)***
id: 2
name: Meeting Agenda (TOC Beta)
channel: meeting-notes
time: 10:00:00
timezone: user_local
questions:

- text: What should we discuss in this meeting?
  answer_type: text
  is_random: False

</Standups>

fetch_reports

Fetches standup reports with support for filtering by:

  • standup_id
  • user_id
  • after
  • before

The response is in a plain text format.

<Reports>
***Report: 1 - 1***
id: 208367845
reporter_name: John Doe | @john_doe
reporter_id: U1234
standup_id: 1
created_at: 2025-03-27 13:52:59
content:
q: What have you done since your last report?
a: • Plan work for the next week
   • Worked on the new feature

q: What will you do today?
a: • Plan work for the next week
   • Worked on the new feature

q: How do you feel today?
a: I am fine.

list_members

Retrieves a list of all members from your Geekbot workspace.

Development

Setup Development Environment

git clone https://github.com/geekbot-com/geekbot-mcp.git
cd geekbot-mcp

uv venv
source .venv/bin/activate

uv pip install -e

Running Tests

pytest

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License

Acknowledgements