Grupy MCP
Grupy connects your AI assistant to the WhatsApp groups on your own account. Ask for a summary of what you missed. Search past summaries. Review join requests. Turn groups on or off.
Power your agent
The publisher's own URL. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
https://mcp.grupy.chat/mcpThe Claude button above opens Claude with the name and URL filled in. You still confirm it there.
claude mcp add --transport http chat.grupy-grupy https://mcp.grupy.chat/mcpRun in a terminal.
{ "mcpServers": { "chat.grupy-grupy": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.grupy.chat/mcp" ] } }}claude_desktop_config.json
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchThis server asks you to sign in when you connect. Your agent handles that.
This repository holds the connection files for Grupy MCP. It has no server code.
The server runs at https://mcp.grupy.chat/mcp (Streamable HTTP).
You need a Grupy account and a linked WhatsApp number. Sign up at https://grupy.chat.
The server URL is the same for both methods:
https://mcp.grupy.chat/mcp
Never put an access key in a file that you share or commit. Use an environment variable.
Each connection has optional permissions. You turn them on in the Grupy dashboard on the MCP page. Tools that need a permission do not appear until you turn that permission on.
Grupy MCP has 28 tools. Every tool has a title and the readOnlyHint, destructiveHint, and openWorldHint annotations.
Read tools set readOnlyHint to true. A tool that cannot be undone sets destructiveHint to true.
Each block below uses the sign-in method unless it says otherwise.
Replace GRUPY_ACCESS_KEY with an environment variable that holds your access key.
https://mcp.grupy.chat/mcp.claude mcp add --transport http grupy https://mcp.grupy.chat/mcp
Then sign in with /mcp inside Claude Code, or run claude mcp login grupy in a shell.
Access key:
claude mcp add --transport http grupy https://mcp.grupy.chat/mcp \
--header "Authorization: Bearer $GRUPY_ACCESS_KEY"
https://mcp.grupy.chat/mcp and choose OAuth.ChatGPT does not send access keys, so use the sign-in method. What you can add depends on your plan and workspace settings.
Add to Cursor
Or add this to ~/.cursor/mcp.json:
{
"mcpServers": {
"grupy": {
"url": "https://mcp.grupy.chat/mcp"
}
}
}
Access key:
{
"mcpServers": {
"grupy": {
"url": "https://mcp.grupy.chat/mcp",
"headers": { "Authorization": "Bearer ${env:GRUPY_ACCESS_KEY}" }
}
}
}
This repository is also a Cursor plugin. See .cursor-plugin/plugin.json.
Install in VS Code
Or add this to .vscode/mcp.json:
{
"servers": {
"grupy": {
"type": "http",
"url": "https://mcp.grupy.chat/mcp"
}
}
}
Access key:
{
"inputs": [
{ "type": "promptString", "id": "grupy-key", "description": "Grupy access key", "password": true }
],
"servers": {
"grupy": {
"type": "http",
"url": "https://mcp.grupy.chat/mcp",
"headers": { "Authorization": "Bearer ${input:grupy-key}" }
}
}
}
In a Copilot Business or Enterprise organization, an administrator must allow MCP servers.
gemini extensions install https://github.com/ai-builders-id/grupy-mcp
Or add the server by hand:
gemini mcp add --transport http grupy https://mcp.grupy.chat/mcp
Access key:
gemini mcp add --transport http --header "Authorization: Bearer $GRUPY_ACCESS_KEY" grupy https://mcp.grupy.chat/mcp
codex mcp add grupy --url https://mcp.grupy.chat/mcp
codex mcp login grupy
Access key. Add this to ~/.codex/config.toml:
[mcp_servers.grupy]
url = "https://mcp.grupy.chat/mcp"
bearer_token_env_var = "GRUPY_ACCESS_KEY"
Add this to cline_mcp_settings.json:
{
"mcpServers": {
"grupy": {
"type": "streamableHttp",
"url": "https://mcp.grupy.chat/mcp",
"disabled": false,
"autoApprove": []
}
}
}
Always set "type": "streamableHttp". Without it, Cline uses the old SSE transport.
For an access key, add "headers": { "Authorization": "Bearer <key>" }.
Cline can also read llms-install.md to set up Grupy for you.
Add this to settings.json:
{
"context_servers": {
"grupy": {
"url": "https://mcp.grupy.chat/mcp"
}
}
}
For an access key, add "headers": { "Authorization": "Bearer <key>" }.
Add to Goose
Or add this to ~/.config/goose/config.yaml:
extensions:
grupy:
name: Grupy
type: streamable_http
uri: https://mcp.grupy.chat/mcp
enabled: true
timeout: 300
openclaw mcp set grupy '{"url":"https://mcp.grupy.chat/mcp","transport":"streamable-http","auth":"oauth","oauth":{"scope":"grupy:read"}}'
openclaw mcp login grupy
Access key. Add this to your OpenClaw configuration:
{
"mcp": {
"servers": {
"grupy": {
"url": "https://mcp.grupy.chat/mcp",
"transport": "streamable-http",
"headers": { "Authorization": "Bearer ${GRUPY_ACCESS_KEY}" }
}
}
}
}
Always set "transport": "streamable-http". With "auth": "oauth", OpenClaw ignores a static Authorization header.
The skills/grupy folder is an OpenClaw skill that teaches the agent how to use the tools.
Add to Hermes
Or add this to ~/.hermes/config.yaml:
mcp_servers:
grupy:
url: "https://mcp.grupy.chat/mcp"
auth: oauth
Then run hermes mcp login grupy. For an access key, replace auth: oauth with
headers: { Authorization: "Bearer ${GRUPY_ACCESS_KEY}" }.
The skills/grupy folder is also a Hermes skill.
Any client that supports remote MCP over Streamable HTTP can connect.
Enter the server URL. Use the sign-in method, or send the Authorization: Bearer <key> header.
LM Studio: add Grupy.
Setup guides for more clients are at https://grupy.chat/en/mcp.
Read the full policy: https://grupy.chat/en/privacy. Terms: https://grupy.chat/en/terms. To delete your account, see https://grupy.chat/en/delete-account.
The files in this repository use the MIT license. See LICENSE. The license does not cover the Grupy service, its server code, or the Grupy name and logo.
Summarize, search, and manage your own WhatsApp groups from any MCP client.
{ "mcpServers": { "chat.grupy-grupy": { "url": "https://mcp.grupy.chat/mcp", "headers": {} } }}Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
No required environment variable is listed on this record.
Grupy is reached over HTTP.
Last checked 2026-11-15. Summarize, search, and manage your own WhatsApp groups from any MCP client.