grumble-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
grumble-mcp
Use Grumble from your coding agent. Claude Code, Cursor, VS Code, Codex or any other agent that speaks MCP can read your servers, channels, DMs and messages, search them, see what's unread, keep an eye on channels, see your notifications, join voice or mute you, set your status, write messages for you to send, and make themes and cosmetics for you, through the Grumble desktop app on your computer.
It only talks to the Grumble app on the same computer. The first time it's used, Grumble asks you in its window what it may do. You can take that back any time in Grumble's Settings, Authorised apps.
It never sends anything as you. A message it writes goes in the conversation's message box in Grumble, and it's sent only when you send it. What it makes is saved as yours, seen only by you until you share it in Discover yourself.
Set it up
You need the Grumble desktop app open and signed in, and Node.js 18 or later.
Claude Code
claude mcp add grumble -- npx -y grumble-mcpCursor, VS Code, Codex and others: add an MCP server that runs npx -y grumble-mcp. In an mcp.json:
{"mcpServers": {"grumble": {"command": "npx", "args": ["-y", "grumble-mcp"]}}}Then ask your agent something like "what's new in #general on Grumble?". The first time, look at Grumble's window and press Allow.
Related MCP server: agent-docs-mcp
Tools
Tool | What it does |
| Who's signed in, and what this tool may do |
| Your servers |
| A server's channels, or your DMs with |
| The latest messages in a channel or DM (encrypted ones opened as you see them), or with |
| Shows a channel or DM in Grumble |
| Starts or stops keeping new messages in a channel |
| New messages in watched channels since last asked |
| Grumble's notifications since last asked |
| Which voice channel you're in, who's there, muted or not |
| Joins or leaves a voice channel |
| Mutes or deafens you |
| Conversations with messages you haven't read, mentions of you first |
| Searches a server's or a DM's messages (encrypted ones searched on your computer) |
| Writes a message (and attaches files) in a conversation's message box, for you to send |
| Your status and custom status |
| Makes a colour theme from five colours |
| Makes a camera filter for calls |
| Makes an avatar decoration, nameplate, profile effect, app icon or camera background from a picture, fitted as it's worn |
| Your themes, filters and cosmetics, and where each is at |
| Shows one of yours in Grumble, to use it, change it or share it |
Making cosmetics? grumble.gg/developers/cosmetics has each kind's size and a prompt for it, and a skill that teaches your agent all of it.
How it signs in
It connects to the Grumble app over the same local connection Discord's apps use, and asks you there. When you say
yes, it signs in with PKCE, without a client secret. Its token is kept on your computer, readable only by you, in
~/.config/grumble-mcp (%APPDATA%\grumble-mcp on Windows). Delete that folder to sign it out here too.
If you set it up before it could write drafts, set your status or make things, Grumble asks you once about those. Say no and it carries on as it was.
Settings
GRUMBLE_SERVER: a Grumble server other thanhttps://chat.grumble.gg.GRUMBLE_CLIENT_ID: your own application to sign in as (a public client: Developer Portal, OAuth2).
More in the developer docs.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Official MCP server for subfeed.app — the cloud for agents. 15+ tools for AI agents to register, build, and deploy other agents. Zero human required. Start here: subfeed.app/skill.md
Official MCP server for Agentwork — delegate tasks to AI agents with human-in-the-loop
Discover MCP servers and A2A agents; verify, message, post, follow, react, and receive webhooks.
Official MCP server for twitterapis.com. Twitter/X search, users, DMs, Grok, monitoring and writes.
Related MCP Servers
- AlicenseBqualityBmaintenanceOfficial MCP server for Shipmail, enabling agents to manage domains, mailboxes, messages, threads, webhooks, and suppressions via natural language.100482 npm1MIT
- AlicenseAqualityDmaintenanceMCP server that provides AI coding agents automatic access to AGENTS.md documentation from GitHub repositories, enabling understanding of codebase conventions and patterns.2Apache 2.0
- AlicenseNot gradedqualityCmaintenanceA Discord MCP server that gives AI agents full control of a Discord bot — messages, channels, roles, threads, forums, events, webhooks, reactions, moderation, image generation, and real-time voice.7MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that lets coding agents read a running Discord client's internals—stores, webpack modules, patches, React props, and gateway traffic—without restarting.GPL 3.0