English Français العربية

io.github.ke4qqq/groupsio

Official registry Other

MCP server for consuming and managing Groups.io data via the Groups.io REST API

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @ke4qqq/groupsio-mcp-server
Claude Code 
claude mcp add groupsio -e 'GROUPSIO_API_KEY=<your groupsio_api_key>' -- npx -y @ke4qqq/groupsio-mcp-server@1.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "groupsio": {
            "command": "npx",
            "args": [
                "-y",
                "@ke4qqq/groupsio-mcp-server@1.0.0"
            ],
            "env": {
                "GROUPSIO_API_KEY": "<your groupsio_api_key>"
            }
        }
    }
}

Environment variables

  • GROUPSIO_API_KEY required secret Groups.io API key from https://groups.io/settings/apikeys

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. groupsio-mcp-server
  2. Prerequisites
  3. Installation
  4. Configuration
  5. Dependencies
  6. Tools
  7. License
  8. Attribution

groupsio-mcp-server

MCP server for consuming and managing Groups.io data via the Groups.io REST API.

Prerequisites

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:

ClientConfig 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

PackageVersionLicensePurpose
@modelcontextprotocol/sdk^1.29.0MITMCP server framework and stdio transport
zod^4.3.6MITInput schema validation

Tools

ToolDescription
list_subscriptionsList all groups you're subscribed to
get_groupGet group settings by ID or name
get_subgroupsGet subgroups of a parent group
get_subgroups_by_categoryGet subgroups organized by category
get_topicsGet message threads in a group
get_topicGet messages within a specific topic
get_messageGet a single message by number
get_messagesGet messages in a group
search_archivesSearch message archives
get_membersGet members of a group
get_member_directoryGet public member directory
search_membersSearch members by email or name
get_hashtagsGet hashtags in a group
get_message_historyGet monthly message count history
get_permissionsGet your permissions in a group
get_eventsGet upcoming events
get_filesGet files in a group
get_wiki_pagesGet wiki pages in a group
get_databasesGet databases in a group
update_subscriptionUpdate your subscription settings (email delivery, message selection, etc.)
delete_subscriptionUnsubscribe from a group

License

This project is released under the MIT-0 license.

Attribution

Written with the aid of Kiro.

Frequently asked questions

What is io.github.ke4qqq/groupsio?

MCP server for consuming and managing Groups.io data via the Groups.io REST API

How do I install io.github.ke4qqq/groupsio?

It runs on your machine. In Claude Code: claude mcp add groupsio -e 'GROUPSIO_API_KEY=<your groupsio_api_key>' -- npx -y @ke4qqq/groupsio-mcp-server@1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.ke4qqq/groupsio need an API key?

Yes. It expects GROUPSIO_API_KEY, which you set in its configuration.

Is io.github.ke4qqq/groupsio open source?

Yes. Its code is on GitHub under the MIT-0 license.

Who maintains io.github.ke4qqq/groupsio?

It is published by ke4qqq. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.