groupsio-mcp-server
MCP server for consuming and managing Groups.io data via the Groups.io REST API.
Prerequisites
- Node.js 18+
- A Groups.io API key (get one at https://groups.io/settings/apikeys)
Installation
git clone https://github.com/ke4qqq/groupsio-mcp-server.git
cd groupsio-mcp-server
npm install
Configuration
Add the server to your MCP client configuration. The exact file varies by client:
| Client | Config file |
|---|---|
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) |
| Kiro | ~/.kiro/settings/mcp.json |
| VS Code (Copilot) | .vscode/mcp.json in your workspace |
Add this entry to the mcpServers object in your config:
{
"mcpServers": {
"groupsio": {
"command": "node",
"args": ["/path/to/groupsio-mcp-server/index.js"],
"env": {
"GROUPSIO_API_KEY": "your_key_here"
}
}
}
}
Dependencies
| Package | Version | License | Purpose |
|---|---|---|---|
| @modelcontextprotocol/sdk | ^1.29.0 | MIT | MCP server framework and stdio transport |
| zod | ^4.3.6 | MIT | Input schema validation |
Tools
| Tool | Description |
|---|---|
list_subscriptions | List all groups you're subscribed to |
get_group | Get group settings by ID or name |
get_subgroups | Get subgroups of a parent group |
get_subgroups_by_category | Get subgroups organized by category |
get_topics | Get message threads in a group |
get_topic | Get messages within a specific topic |
get_message | Get a single message by number |
get_messages | Get messages in a group |
search_archives | Search message archives |
get_members | Get members of a group |
get_member_directory | Get public member directory |
search_members | Search members by email or name |
get_hashtags | Get hashtags in a group |
get_message_history | Get monthly message count history |
get_permissions | Get your permissions in a group |
get_events | Get upcoming events |
get_files | Get files in a group |
get_wiki_pages | Get wiki pages in a group |
get_databases | Get databases in a group |
update_subscription | Update your subscription settings (email delivery, message selection, etc.) |
delete_subscription | Unsubscribe from a group |
License
This project is released under the MIT-0 license.
Attribution
Written with the aid of Kiro.