guMCP 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.
While many MCP server providers are closed source, and open-source alternatives typically only support local hosting through stdio, guMCP provides:
- A comprehensive collection of MCP servers that work both locally and remotely
- Support for both stdio and SSE (Server-Sent Events) transports
- A unified backend architecture for consistent implementation
- Full open-source access to encourage community contributions
🎬 RECOMMENDED: Watch our quick setup video before getting started!
This under 5-minute walkthrough will save you time and help you understand the key concepts.
- Python 3.11
- Git
- For Windows users: A bash-compatible shell is recommended (Git Bash, WSL, etc.)
-
Clone the repository:
git clone https://github.com/gumloop/guMCP.git cd guMCP -
Set up a virtual environment:
This isolates the project dependencies from your system Python installation.
# Create the virtual environment python -m venv venv # Activate it (choose the appropriate command for your OS) # On Unix/macOS: source venv/bin/activate # On Windows (Command Prompt): venv\Scripts\activate # On Windows (PowerShell): .\venv\Scripts\Activate.ps1 # On Windows (Git Bash): source venv/Scripts/activate
You'll know your virtual environment is active when you see
(venv)at the beginning of your command prompt. -
Install dependencies:
# Install core dependencies pip install -r requirements.txt # Install development dependencies (for contributing) pip install -r requirements-dev.txt
-
Configure environment variables:
# Create a local environment file from the template cp .env.example .env # Open the .env file in your preferred text editor and update values as needed # If you're using VS Code: code .env
The
.envfile contains configuration for:- API keys for service integrations
- Authentication settings
- Server configuration options
- Development environment settings
An SSE server can be run locally. This will provide a single URL and host every server available.
To start the SSE development server, run:
./start_sse_dev_server.shFor convenience, we also provide a lightweight MCP Client to connect to SSE servers. Usage:
python tests/clients/RemoteMCPTestClient.py --endpoint=http://localhost:8000/simple-tools-server/localpython src/servers/local.py --server=simple-tools-serverFor convenience, we also provide a lightweight MCP Client to start and connect to stdio servers. Usage:
python tests/clients/LocalMCPTestClient.py --server=simple-tools-serverThe following table provides an overview of the current servers implemented in guMCP, their authentication requirements, and relative ease of use with different authentication methods:
| Server | Auth Type | Remote Auth (e.g., Cursor) |
Local Auth (e.g., Claude Desktop) |
Documentation |
|---|---|---|---|---|
| Google Services | ||||
| Google Sheets | OAuth 2.0 | ✅ Seamless with Gumloop auth | GSheets Docs | |
| Gmail | OAuth 2.0 | ✅ Seamless with Gumloop auth | Gmail Docs | |
| Google Docs | OAuth 2.0 | ✅ Seamless with Gumloop auth | GDocs Docs | |
| Google Drive | OAuth 2.0 | ✅ Seamless with Gumloop auth | GDrive Docs | |
| Google Calendar | OAuth 2.0 | ✅ Seamless with Gumloop auth | GCalendar Docs | |
| Google Maps | API Key | GMaps Docs | ||
| Google Meet | OAuth 2.0 | GMeet Docs | ||
| YouTube | OAuth 2.0 | ✅ Seamless with Gumloop auth | YouTube Docs | |
| Communication Tools | ||||
| Slack | OAuth 2.0 | ✅ Seamless with Gumloop auth | Slack Docs | |
| Outlook | OAuth 2.0 | ✅ Seamless with Gumloop auth | Outlook Docs | |
| Discourse | API Key | ✅ Seamless with Gumloop auth | ✅ Easy - Simple API key setup | Discourse Docs |
| X (Twitter) | OAuth 2.0 | X Docs | ||
| OAuth 2.0 | ✅ Seamless with Gumloop auth | Reddit Docs | ||
| Intercom | OAuth 2.0 | Intercom Docs | ||
| Productivity Tools | ||||
| Airtable | OAuth 2.0 | ✅ Seamless with Gumloop auth | Airtable Docs | |
| Linear | OAuth 2.0 | ✅ Seamless with Gumloop auth | Linear Docs | |
| Attio | Mixed | ✅ Seamless with Gumloop auth | Attio Docs | |
| Notion | OAuth 2.0 | ✅ Seamless with Gumloop auth | Notion Docs | |
| Dropbox | OAuth 2.0 | Dropbox Docs | ||
| Jira | OAuth 2.0 | ✅ Seamless with Gumloop auth | Jira Docs | |
| Calendly | OAuth 2.0 | ✅ Seamless with Gumloop auth | Calendly Docs | |
| Business Tools | ||||
| Apollo | API Key | ✅ Seamless with Gumloop auth | ✅ Easy - Simple API key setup | Apollo Docs |
| HubSpot | OAuth 2.0 | ✅ Seamless with Gumloop auth | HubSpot Docs | |
| SendGrid | API Key | ✅ Seamless with Gumloop auth | ✅ Easy - Simple API key setup | SendGrid Docs |
| QuickBooks | OAuth 2.0 | QuickBooks Docs | ||
| Typeform | API Key | ✅ Seamless with Gumloop auth | ✅ Easy - Simple API key setup | Typeform Docs |
| Stripe | OAuth 2.0 | ✅ Seamless with Gumloop auth | Stripe Docs | |
| Instacart | API Key | ✅ Seamless with Gumloop auth | ✅ Easy - Simple API key setup | Instacart Docs |
| Search Tools | ||||
| Perplexity | API Key | ✅ Seamless with Gumloop auth | ✅ Easy - Simple API key setup | Perplexity Docs |
| Hacker News | None | ✅ No auth required | ✅ No auth required | Hacker News Docs |
| Development Tools | ||||
| Figma | OAuth 2.0 | Figma Docs | ||
| GitHub | OAuth 2.0 | GitHub Docs | ||
| Simple Tools Server | None | ✅ No auth required | ✅ No auth required | Simple Tools Docs |
We welcome contributions! Please see our CONTRIBUTING.md for guidelines.
Key areas for contribution:
- New server implementations
- Transport improvements
- Documentation
- Test coverage
- Bug fixes
This project is licensed under the GNU General Public License v3.0 (GPL-3.0) - see the LICENSE file for details
Security is the single highest priority for us.
That's why Gumloop is SOC 2 Type II, GDPR, and HIPAA compliant, and why for this OSS repo, we're actively rewarding those who responsibly disclose serious vulnerabilities and exploits to security@gumloop.com.
- GitHub Issues: Bug reports and feature requests
- GitHub Discussions: General questions and discussions
- Forum: Community discussions and support
This 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.
Thank you to all the contributors that have provided feedback, advice, and early servers for the repository.