About groupsio
groupsio is an MCP server for reading and managing Groups.io data through its REST API. It serves users who want to work with group messages, members, files, and subscription settings from an MCP client.
Key features
- 01Browse groups, subgroups, and subscriptions
- 02Read topics, messages, and message history
- 03Search archives and group members
- 04View events, files, wikis, and databases
- 05Change subscription settings or unsubscribe
Use cases
- 01Find older messages in a group
- 02Review group members and public directories
- 03Adjust delivery and other subscription options
MCP support
It exposes tools to MCP clients for accessing Groups.io data and managing subscriptions through the Groups.io REST API.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @ke4qqq/groupsio-mcp-serverGROUPSIO_API_KEYSecretGroups.io API key from https://groups.io/settings/apikeysLocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
21Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | number | No | Max results (1-100, default 10) |
| page_token | string | No | Pagination token |
Details
From the project READMEgroupsio-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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.