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.