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) 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 Information: List all standups in your Geekbot workspace. 📊
- Retrieve Standup Reports: Fetch reports with filters for specific standups, users, or date ranges. 📄
- View Team Members: Get a list of members you collaborate with in Geekbot. 👥
Installation 💻
Requires Python 3.10+ and uv
.
- Install uv (if you haven't already):(See uv installation docs for more options.)Copy
- Install Geekbot MCP:Copy
Upgrading ⬆️
To update to the latest version:
Configuration ⚙️
Connect Geekbot MCP to your LLM (e.g., Claude Desktop):
- Get your Geekbot API Key: Find it in your Geekbot API/Webhooks settings 🔑.
- Find your
uv
executable path:Copy - Configure your LLM client application: Edit your
claude_desktop_config.json
(or equivalent configuration file for other MCP clients) to add Geekbot MCP server(Refer to the MCP Quickstart for more details on client configuration.)Copy
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.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.
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.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
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 💻
- Upgrading ⬆️
- 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