io.github.ke4qqq/groupsio
MCP server for consuming and managing Groups.io data via the Groups.io REST API
Open source Open in the app JSON README (API)
About
MCP server for consuming and managing Groups.io data via the Groups.io REST API
Details
- Kind
- MCP servers
- Topic
- Developer tools
- Publisher
- ke4qqq
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.0
- Stars
- 1
- Last push
- 2026-04-11T17:26:34Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT-0
- Added
- 2026-08-29 04:00:20
- Updated
- 2026-08-29 04:00:20
- Origin id
io.github.ke4qqq/groupsio
README
# 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
```bash
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:
```json
{
"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](https://www.npmjs.com/package/@modelcontextprotocol/sdk) | ^1.29.0 | MIT | MCP server framework and stdio transport |
| [zod](https://www.npmjs.com/package/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](https://opensource.org/license/mit-0) license.
## Attribution
Written with the aid of [Kiro](https://kiro.dev).