The Geekbot MCP server enables seamless interaction with Geekbot data within LLM applications via natural language. You can:
- Fetch Standups: Retrieve a list of all standups from your workspace
- Fetch Reports: Retrieve standup reports with filters for standup ID, user ID, and date range
- List Polls: View all available polls
- Post Reports: Submit new standup reports
- List Team Members: Access team member information
- Retrieve Poll Results: Get data from completed polls
- Generate Weekly Rollups: Create comprehensive weekly summary reports
Geekbot MCP
Unlock your Geekbot data within your LLM applications 🚀
Geekbot MCP (Model Context Protocol) server acts as a bridge, connecting LLM client applications (like Claude, Cursor, Windsurf, etc.) directly to your Geekbot workspace. This allows you to interact with your standups, reports, and team members seamlessly within your conversations using natural language.
Key Features ✨
- Access Standup and Poll Information: List all standups and polls in your Geekbot workspace. 📊
- Retrieve Standup Reports and Poll Results: Fetch reports and poll results with filters for specific standups, users, or date ranges. 📄
- View Team Members: Get a list of members you collaborate with in Geekbot. 👥
- Post Standup Reports: Post a standup report to Geekbot. 📝
Check the video:
Installation 💻
Installing via Smithery
To install Geekbot MCP as a remote server via Smithery:
The remote server will automatically be updated to the latest version with each release.
More information onSmithery's Data Policy
Manual Installation
Requires Python 3.10+ and uv
.
- Install Python 3.10+ (if you haven't already):
- macOS:See Homebrew Python installation guide for more details.
- Ubuntu/Debian:
- Windows: Download and install from Python.org.See Windows Python installation guide for more details.
- macOS:
- Install uv (if you haven't already):
- macOS/Linux:
In your terminal, run the following command:
- Windows:
In your PowerShell, run the following command:
(See uv installation docs for more options.)
- macOS/Linux:
In your terminal, run the following command:
- Install/Upgrade Geekbot MCP:
- macOS/Linux:
In your terminal, run the following command:
- Windows:
In your PowerShell, run the following command:
- macOS/Linux:
In your terminal, run the following command:
Configuration ⚙️
After installling Geekbot MCP, you can connect it to your an LLM client desktop application (e.g., Claude Desktop, Cursor, Windsurf, etc.):
- Get your Geekbot API Key: Find it in your Geekbot API/Webhooks settings 🔑.
- Find your
uv
executable path:
- Linux/macOS:
In your terminal, run the following command:
- Windows:
In your PowerShell, run the following command:
- Configure your LLM client desktop application: Each LLM client that supports MCP provides a configuration file that you can edit to add Geekbot MCP server.
If you are using a different LLM client, please refer to the documentation of your client to learn how to configure the MCP server.
After you locate the configuration file, edit it to add Geekbot MCP server:
Make sure to replace:
UV-PATH
with the path to youruv
executable from step 2YOUR-API-KEY
with your Geekbot API key from step 1
Usage 💡
Once configured, your LLM client application will have access to the following tools and prompts to interact with your Geekbot data:
Tools 🛠️
list_standups
Purpose: Lists all the standups accessible via your API key. Useful for getting an overview or finding a specific standup ID.
Example Prompt: "Hey, can you list my Geekbot standups?"
Data Fields Returned:
id
: Unique standup identifier.name
: Name of the standup.channel
: Associated communication channel (e.g., Slack channel).time
: Scheduled time for the standup report.timezone
: Timezone for the scheduled time.questions
: List of questions asked in the standup.participants
: List of users participating in the standup.owner_id
: ID of the standup owner.confidential
: Whether the standup is confidential.anonymous
: Whether the standup is anonymous.
list_polls
Purpose: Lists all the polls accessible via your API key. Useful for getting an overview or finding a specific poll ID.
Example Prompt: "Hey, can you list my Geekbot polls?"
Data Fields Returned:
id
: Unique poll identifier.name
: Name of the poll.time
: Scheduled time for the poll.timezone
: Timezone for the scheduled time.questions
: List of questions asked in the poll.participants
: List of users participating in the poll.creator
: The poll creator.
fetch_reports
Purpose: Retrieves specific standup reports. You can filter by standup, user, and date range.
Example Prompts:
- "Fetch the reports for submitted yesterday in the Retrospective."
- "Show me reports from user John Doe for the 'Weekly Sync' standup."
- "Get all reports submitted to the Daily Standup standup after June 1st, 2024."
Available Filters:
standup_id
: Filter by a specific standup ID.user_id
: Filter reports by a specific user ID.after
: Retrieve reports submitted after this date (YYYY-MM-DD) 🗓️.before
: Retrieve reports submitted before this date (YYYY-MM-DD) 🗓️.
Data Fields Returned:
id
: Unique report identifier.reporter_name
: Name of the user who submitted the report.reporter_id
: ID of the user who submitted the report.standup_id
: ID of the standup the report belongs to.created_at
: Timestamp when the report was submitted.content
: The actual answers/content of the report.
post_report
Purpose: Posts a report to Geekbot.
Example Prompt: "Hey, can you post the report for the Daily Standup standup?"
Data Fields Returned:
id
: Unique report identifier.reporter_name
: Name of the user who submitted the report.reporter_id
: ID of the user who submitted the report.standup_id
: ID of the standup the report belongs to.created_at
: Timestamp when the report was submitted.content
: The actual answers/content of the report.
list_members
Purpose: Lists all team members you share standups with in your Geekbot workspace.
Example Prompt: "Who are the members in my Geekbot workspace?"
Data Fields Returned:
id
: Unique member identifier.name
: Member's full name.email
: Member's email address.role
: Member's role within Geekbot (e.g., Admin, Member).
fetch_poll_results
Purpose: Retrieves specific poll results. Requires a poll id and optionally a date range.
Example Prompt: "Hey, what was decided about the new logo in Geekbot polls?"
Data Fields Returned:
total_results
: Total number of results.question_results
: List of question results.
Prompts 💬
weekly_rollup_report
Purpose: Generates a comprehensive weekly rollup report that summarizes team standup responses, highlights key updates, identifies risks and mitigation strategies, outlines next steps, and tracks upcoming launches.
Tips 💡
- Review Tool Usage: Make the agent ask for your explicit approval for each tool action and not allow automatic tool calls. This safety feature ensures you maintain control over sensitive operations, particularly when posting reports to Geekbot. You'll be prompted to review and approve each tool call before execution, helping prevent unintended data submissions.
- Ask for preview: Before posting a report, ask the agent to preview the report and not actually post it. This will give you a chance to review the report and make sure it is correct or make changes to it before posting it to Geekbot.
- Limit the volume of retrieved data: If you are using the
fetch_reports
tool, limit the date range to a reasonable period. This will help prevent the agent from retrieving a large amount of data and causing performance issues. Have in mind that the agent will apply limits in the number of reports it can retrieve.
Arguments:
standup_id
: ID of the standup to include in the rollup report.
Development 🧑💻
Interested in contributing or running the server locally?
Setup Development Environment
Running Tests ✅
Contributing 🤝
Contributions are welcome! Please fork the repository and submit a Pull Request with your changes.
License 📜
This project is licensed under the MIT License.
Acknowledgements 🙏
- Built upon the Anthropic Model Context Protocol framework.
- Leverages the official Geekbot API.
You must be authenticated.
local-only server
The server can only run on the client's local machine because it depends on local resources.
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.
- Key Features ✨
- Installation 💻
- Configuration ⚙️
- Usage 💡
- Development 🧑💻
- Contributing 🤝
- License 📜
- Acknowledgements 🙏
Related Resources
Related MCP Servers
- AsecurityFlicenseAqualityA server that enables Claude Desktop users to access the Claude API directly, allowing them to bypass Professional Plan limitations and use advanced features like custom system prompts and conversation management.Last updated -15Python
JSON Resume MCP Serverofficial
AsecurityAlicenseAqualityA server that enhances AI assistants with the ability to update your JSON Resume by analyzing your coding projects, automatically extracting skills and generating professional descriptions.Last updated -33239TypeScriptThe Unlicense- -securityAlicense-qualityA modular server implementation for Claude AI assistants with integrated tools, enabling Claude to perform actions and access external resources like file systems, web searches, browser automation, financial data, and document generation.Last updated -45PythonMIT License
- -securityAlicense-qualityA server that integrates with Claude Desktop to enable real-time web research capabilities, allowing users to search Google, extract webpage content, and capture screenshots directly from conversations.Last updated -854MIT License