{"id":27063758,"url":"https://github.com/gumloop/gumcp","last_synced_at":"2025-05-16T17:08:32.426Z","repository":{"id":284968043,"uuid":"951598835","full_name":"gumloop/guMCP","owner":"gumloop","description":"Gumloop Unified Model Context Protocol (guMCP)","archived":false,"fork":false,"pushed_at":"2025-04-11T20:44:55.000Z","size":1804,"stargazers_count":317,"open_issues_count":12,"forks_count":29,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-04-11T21:22:49.998Z","etag":null,"topics":["ai","automation","mcp","mcp-server","workflow"],"latest_commit_sha":null,"homepage":"https://www.gumloop.com/mcp","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gumloop.png","metadata":{"files":{"readme":"README.MD","changelog":null,"contributing":"CONTRIBUTING.MD","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-20T00:01:52.000Z","updated_at":"2025-04-11T13:20:12.000Z","dependencies_parsed_at":"2025-04-04T18:26:30.060Z","dependency_job_id":null,"html_url":"https://github.com/gumloop/guMCP","commit_stats":null,"previous_names":["gumloop/gumcp"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gumloop%2FguMCP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gumloop%2FguMCP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gumloop%2FguMCP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gumloop%2FguMCP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gumloop","download_url":"https://codeload.github.com/gumloop/guMCP/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248643006,"owners_count":21138353,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","automation","mcp","mcp-server","workflow"],"created_at":"2025-04-05T16:20:55.358Z","updated_at":"2025-05-16T17:08:32.415Z","avatar_url":"https://github.com/gumloop.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gumloop Unified Model Context Protocol (guMCP)\n\nguMCP is an open-source collection of Model Context Protocol (MCP) servers that can be run both remotely and locally. The project aims to create the largest collection of MCP servers with a unified backend, fostering a community around AI integrations and the future of AGI.\n \n## Overview\n\nWhile many MCP server providers are closed source, and open-source alternatives typically only support local hosting through stdio, guMCP provides:\n\n- A comprehensive collection of MCP servers that work both locally and remotely\n- Support for both stdio and SSE (Server-Sent Events) transports\n- A unified backend architecture for consistent implementation\n- Full open-source access to encourage community contributions\n\n## Getting Started\n\n\u003e **🎬 RECOMMENDED: Watch our quick setup video before getting started!**\n\u003e\n\u003e This under 5-minute walkthrough will save you time and help you understand the key concepts.\n\u003e\n\u003e [![Watch the guMCP Getting Started Video](https://www.gumloop.com/_next/image?url=%2Fimages%2Fmcp%2FGuideVideo.png\u0026w=1920\u0026q=75)](https://vimeo.com/1070438737/8dea56e6a1)\n\n### Prerequisites\n\n- Python 3.11\n- Git\n- For Windows users: A bash-compatible shell is recommended (Git Bash, WSL, etc.)\n\n### Installation\n\n1. **Clone the repository**:\n\n   ```bash\n   git clone https://github.com/gumloop/guMCP.git\n   cd guMCP\n   ```\n\n2. **Set up a virtual environment**:\n\n   This isolates the project dependencies from your system Python installation.\n\n   ```bash\n   # Create the virtual environment\n   python -m venv venv\n\n   # Activate it (choose the appropriate command for your OS)\n   # On Unix/macOS:\n   source venv/bin/activate\n\n   # On Windows (Command Prompt):\n   venv\\Scripts\\activate\n\n   # On Windows (PowerShell):\n   .\\venv\\Scripts\\Activate.ps1\n\n   # On Windows (Git Bash):\n   source venv/Scripts/activate\n   ```\n\n   You'll know your virtual environment is active when you see `(venv)` at the beginning of your command prompt.\n\n3. **Install dependencies**:\n\n   ```bash\n   # Install core dependencies\n   pip install -r requirements.txt\n\n   # Install development dependencies (for contributing)\n   pip install -r requirements-dev.txt\n   ```\n\n4. **Configure environment variables**:\n\n   ```bash\n   # Create a local environment file from the template\n   cp .env.example .env\n\n   # Open the .env file in your preferred text editor and update values as needed\n   # If you're using VS Code:\n   code .env\n   ```\n\n   The `.env` file contains configuration for:\n\n   - API keys for service integrations\n   - Authentication settings\n   - Server configuration options\n   - Development environment settings\n\nNote: For local usage, by default, the `local_auth` folder should be located in the root of the repository\n\n## Usage\n\n### Running SSE Servers\n\nAn SSE server can be run locally. This will provide a single URL and host every server available.\n\nTo start the SSE development server, run:\n\n```bash\n./start_sse_dev_server.sh\n```\n\nFor convenience, we also provide a lightweight MCP Client to connect to SSE servers. Usage:\n\n```bash\npython tests/clients/RemoteMCPTestClient.py --endpoint=http://localhost:8000/simple-tools-server/local\n```\n\n### Running Stdio Servers\n\n```bash\npython src/servers/local.py --server=simple-tools-server\n```\n\nFor convenience, we also provide a lightweight MCP Client to start and connect to stdio servers. Usage:\n\n```bash\n python tests/clients/LocalMCPTestClient.py --server=simple-tools-server\n```\n\n## Supported Servers and Authentication Methods\n\nThe following table provides an overview of the current servers implemented in guMCP, their authentication requirements, and relative ease of use with different authentication methods:\n\n| Server                  | Auth Type | Remote Auth\u003cbr\u003e(e.g., Cursor)                                            | Local Auth\u003cbr\u003e(e.g., Claude Desktop)                 | Documentation                                                   |\n| ----------------------- | --------- | ------------------------------------------------------------------------ | ---------------------------------------------------- | --------------------------------------------------------------- |\n| **Google Services**     |           |                                                                          |                                                      |                                                                 |\n| Google Sheets           | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/gsheets)     | ⚠️ Requires GCP project \u0026 OAuth setup                | [GSheets Docs](/src/servers/gsheets/README.md)                  |\n| Gmail                   | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/gmail)       | ⚠️ Requires GCP project \u0026 OAuth setup                | [Gmail Docs](/src/servers/gmail/README.md)                      |\n| Google Docs             | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/gdocs)       | ⚠️ Requires GCP project \u0026 OAuth setup                | [GDocs Docs](/src/servers/gdocs/README.md)                      |\n| Google Drive            | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/gdrive)      | ⚠️ Requires GCP project \u0026 OAuth setup                | [GDrive Docs](/src/servers/gdrive/README.md)                    |\n| Google Calendar         | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/gcalendar)   | ⚠️ Requires GCP project \u0026 OAuth setup                | [GCalendar Docs](/src/servers/gcalendar/README.md)              |\n| Google Maps             | API Key   | ⚠️ Coming soon                                                           | ⚠️ Requires GCP project \u0026 API Key                    | [GMaps Docs](/src/servers/gmaps/README.md)                      |\n| Google Meet             | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/gmeet)       | ⚠️ Requires GCP project \u0026 OAuth setup                | [GMeet Docs](/src/servers/gmeet/README.md)                      |\n| YouTube                 | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/youtube)     | ⚠️ Requires GCP project \u0026 OAuth setup                | [YouTube Docs](/src/servers/youtube/README.md)                  |\n| **Communication Tools** |           |                                                                          |                                                      |                                                                 |\n| Slack                   | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/slack)       | ⚠️ Requires OAuth setup with HTTPS redirect          | [Slack Docs](/src/servers/slack/README.md)                      |\n| Microsoft Teams         | OAuth 2.0 | ⚠️ Coming soon                                                           | ⚠️ Requires Azure app registration                   | [Teams Docs](/src/servers/teams/README.md)                      |\n| Outlook                 | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/outlook)     | ⚠️ Requires Azure app registration                   | [Outlook Docs](/src/servers/outlook/README.md)                  |\n| Discourse               | API Key   | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/discourse)   | ✅ Easy - Simple API key setup                       | [Discourse Docs](/src/servers/discourse/README.md)              |\n| X (Twitter)             | OAuth 2.0 | ⚠️ Coming soon                                                           | ⚠️ Requires X Developer Account                      | [X Docs](/src/servers/x/README.md)                              |\n| Bluesky                 | API Key   | ⚠️ Coming soon                                                           | ✅ Easy - Simple API key setup                       | [Bluesky Docs](/src/servers/bluesky/README.md)                  |\n| Reddit                  | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/reddit)      | ⚠️ Requires Reddit Developer App                     | [Reddit Docs](/src/servers/reddit/README.md)                    |\n| Intercom                | OAuth 2.0 | ⚠️ Coming soon                                                           | ⚠️ Requires Intercom OAuth App                       | [Intercom Docs](/src/servers/intercom/README.md)                |\n| Zoom                    | OAuth 2.0 | ⚠️ Coming soon                                                           | ⚠️ Requires Zoom Developer App                       | [Zoom Docs](/src/servers/zoom/README.md)                        |\n| Twilio                  | API Key   | ⚠️ Coming soon                                                           | ✅ Easy - Simple API key setup                       | [Twilio Docs](/src/servers/twilio/README.md)                    |\n| **Productivity Tools**  |           |                                                                          |                                                      |                                                                 |\n| Airtable                | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/airtable)    | ⚠️ Requires Airtable OAuth application               | [Airtable Docs](/src/servers/airtable/README.md)                |\n| Excel                   | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/excel)       | ⚠️ Requires Microsoft OAuth application              | [Excel Docs](/src/servers/excel/README.md)                      |\n| Word                    | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/word)        | ⚠️ Requires Microsoft OAuth application              | [Word Docs](/src/servers/word/README.md)                        |\n| Linear                  | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/linear)      | ⚠️ Requires Linear OAuth application                 | [Linear Docs](/src/servers/linear/README.md)                    |\n| Monday.com              | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/monday)      | ⚠️ Requires Monday.com OAuth application             | [Monday.com Docs](/src/servers/monday/README.md)                |\n| Attio                   | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/attio)       | ⚠️ Requires Attio OAuth application                  | [Attio Docs](/src/servers/attio/README.md)                      |\n| Notion                  | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/notion)      | ⚠️ Requires Notion OAuth application                 | [Notion Docs](/src/servers/notion/README.md)                    |\n| Loops                   | OAuth 2.0 | ⚠️ Coming soon                                                           | ✅ Easy - Simple API key setup                       | [Loops Docs](/src/servers/loops/README.md)                      |\n| Webflow                 | OAuth 2.0 | ⚠️ Coming soon                                                           | ⚠️ Requires Webflow OAuth application                | [Webflow Docs](/src/servers/webflow/README.md)                  |\n| ClickUp                 | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/clickup)     | ⚠️ Requires ClickUp OAuth application                | [ClickUp Docs](/src/servers/clickup/README.md)                  |\n| Dropbox                 | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/dropbox)     | ⚠️ Requires Dropbox OAuth application                | [Dropbox Docs](/src/servers/dropbox/README.md)                  |\n| OneDrive                | OAuth 2.0 | ⚠️ Coming soon                                                           | ⚠️ Requires Microsoft OAuth application              | [OneDrive Docs](/src/servers/onedrive/README.md)                |\n| SharePoint              | OAuth 2.0 | ⚠️ Coming soon                                                           | ⚠️ Requires Microsoft OAuth application              | [SharePoint Docs](/src/servers/sharepoint/README.md)            |\n| Jira                    | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/jira)        | ⚠️ Requires Atlassian OAuth 2.0 (3LO) setup          | [Jira Docs](/src/servers/jira/README.md)                        |\n| Calendly                | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/calendly)    | ⚠️ Requires Calendly OAuth application               | [Calendly Docs](/src/servers/calendly/README.md)                |\n| Cal.com                 | API Key   | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/calcom)      | ⚠️ Requires Cal.com API key setup                    | [Cal.com Docs](/src/servers/calcom/README.md)                   |\n| Canva                   | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/canva)       | ⚠️ Requires Canva OAuth integration                  | [Canva Docs](/src/servers/canva/README.md)                      |\n| **Business Tools**      |           |                                                                          |                                                      |                                                                 |\n| Apollo                  | API Key   | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/apollo)      | ✅ Easy - Simple API key setup                       | [Apollo Docs](/src/servers/apollo/README.md)                    |\n| HubSpot                 | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/hubspot)     | ⚠️ Requires HubSpot OAuth application                | [HubSpot Docs](/src/servers/hubspot/README.md)                  |\n| Hunter.io               | API Key   | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/hunter)      | ✅ Easy - Simple API key setup                       | [Hunter.io Docs](/src/servers/hunter_io/README.md)              |\n| Lemlist                 | API Key   | ⚠️ Coming soon                                                           | ✅ Easy - Simple API key setup                       | [Lemlist Docs](/src/servers/lemlist/README.md)                  |\n| SendGrid                | API Key   | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/sendgrid)    | ✅ Easy - Simple API key setup                       | [SendGrid Docs](/src/servers/sendgrid/README.md)                |\n| QuickBooks              | OAuth 2.0 | ⚠️ Coming soon                                                           | ⚠️ Requires Intuit OAuth application                 | [QuickBooks Docs](/src/servers/quickbooks/README.md)            |\n| Typeform                | API Key   | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/typeform)    | ✅ Easy - Simple API key setup                       | [Typeform Docs](/src/servers/typeform/README.md)                |\n| Stripe                  | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/stripe)      | ⚠️ Requires Stripe OAuth setup                       | [Stripe Docs](/src/servers/stripe/README.md)                    |\n| MailerLite              | API Key   | ⚠️ Coming soon                                                           | ✅ Easy - Simple API key setup                       | [MailerLite Docs](/src/servers/mailerlite/README.md)            |\n| Mailchimp               | OAuth 2.0 | ⚠️ Coming soon                                                           | ⚠️ Requires Mailchimp OAuth application              | [Mailchimp Docs](/src/servers/mailchimp/README.md)              |\n| Klaviyo                 | OAuth 2.0 | ⚠️ Coming soon                                                           | ⚠️ Requires Klaviyo OAuth application                | [Klaviyo Docs](/src/servers/klaviyo/README.md)                  |\n| PayPal                  | OAuth 2.0 | ⚠️ Coming soon                                                           | ⚠️ Requires PayPal OAuth setup                       | [PayPal Docs](/src/servers/paypal/README.md)                    |\n| Instacart               | API Key   | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/instacart)   | ✅ Easy - Simple API key setup                       | [Instacart Docs](/src/servers/instacart/README.md)              |\n| PagerDuty               | OAuth 2.0 | ⚠️ Coming soon                                                           | ⚠️ Requires PagerDuty OAuth application              | [PagerDuty Docs](/src/servers/pagerduty/README.md)              |\n| Shopify                 | OAuth 2.0 | ⚠️ Coming soon                                                           | ⚠️ Requires Shopify OAuth Application                | [Shopify Docs](/src/servers/shopify/README.md)                  |\n| DocuSign                | OAuth 2.0 | ⚠️ Coming soon                                                           | ⚠️ Requires OAuth setup                              | [DocuSign Docs](/src/servers/docusign/README.md)                |\n| Patreon                 | OAuth 2.0 | ⚠️ Coming soon                                                           | ⚠️ Requires Patreon OAuth application                | [Patreon Docs](/src/servers/patreon/README.md)                  |\n| PostHog                 | API Key   | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/posthog)     | ✅ Easy - Simple API key setup                       | [PostHog Docs](/src/servers/posthog/README.md)                  |\n| Salesforce              | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/salesforce)  | ⚠️ Requires Salesforce Connected App setup           | [Salesforce Docs](/src/servers/salesforce/README.md)            |\n| **Search Tools**        |           |                                                                          |                                                      |                                                                 |\n| Perplexity              | API Key   | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/perplexity)  | ✅ Easy - Simple API key setup                       | [Perplexity Docs](/src/servers/perplexity/README.md)            |\n| Ahrefs                  | API Key   | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/ahrefs)      | ✅ Easy - Simple API key setup                       | [Ahrefs Docs](/src/servers/ahrefs/README.md)                    |\n| Firecrawl               | API Key   | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/firecrawl)   | ✅ Easy - Simple API key setup                       | [Firecrawl Docs](/src/servers/firecrawl/README.md)              |\n| SerpAPI                 | API Key   | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/serpapi)     | ✅ Easy - Simple API key setup                       | [SerpAPI Docs](/src/servers/serpapi/README.md)                  |\n| Hacker News             | None      | ✅ No auth required                                                      | ✅ No auth required                                  | [Hacker News Docs](/src/servers/hackernews/README.md)           |\n| Reducto                 | API Key   | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/reducto)     | ✅ Easy - Simple API key setup                       | [Reducto Docs](/src/servers/reducto/README.md)                  |\n| Apify                   | API Key   | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/apify)       | ✅ Easy - Simple API key setup                       | [Apify Docs](/src/servers/apify/README.md)                      |\n| **Development Tools**   |           |                                                                          |                                                      |                                                                 |\n| Figma                   | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/figma)       | ⚠️ Requires Figma OAuth application                  | [Figma Docs](/src/servers/figma/README.md)                      |\n| GitHub                  | OAuth 2.0 | ⚠️ Coming soon                                                           | ⚠️ Requires GitHub OAuth application                 | [GitHub Docs](/src/servers/github/README.md)                    |\n| Browserbase             | API Key   | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/browserbase) | ✅ Easy - Simple API key setup                       | [Browserbase Docs](/src/servers/browserbase/README.md)          |\n| Snowflake               | OAuth 2.0 | [✅ Seamless with Gumloop auth](https://www.gumloop.com/mcp/snowflake)   | ⚠️ Requires Snowflake Security Integration for OAuth | [Snowflake Docs](/src/servers/snowflake/README.md)              |\n| Simple Tools Server     | None      | ✅ No auth required                                                      | ✅ No auth required                                  | [Simple Tools Docs](/src/servers/simple-tools-server/README.md) |\n\n## Contributing\n\nWe welcome contributions! Please see our [CONTRIBUTING.md](CONTRIBUTING.MD) for guidelines.\n\nKey areas for contribution:\n\n- New server implementations\n- Transport improvements\n- Documentation\n- Test coverage\n- Bug fixes\n\n## License\n\nThis project is licensed under the GNU General Public License v3.0 (GPL-3.0) - see the [LICENSE](LICENSE) file for details\n\n## Security\n\nSecurity is the single highest priority for us.\n\nThat's why [Gumloop is SOC 2 Type II, GDPR, and HIPAA compliant](https://trust.gumloop.com/), and why for this OSS repo, we're actively rewarding those who responsibly disclose serious vulnerabilities and exploits to security@gumloop.com.\n\n## Community\n\n- GitHub Issues: Bug reports and feature requests\n- GitHub Discussions: General questions and discussions\n- [Forum](https://forum.gumloop.com/): Community discussions and support\n\n## Acknowledgments\n\nThis project builds on the Model Context Protocol (MCP) specification and is inspired by the work of various MCP implementations in the community, especially those at Anthropic.\n\nThank you to all the contributors that have provided feedback, advice, and early servers for the repository.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgumloop%2Fgumcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgumloop%2Fgumcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgumloop%2Fgumcp/lists"}