Discord — Claude Code MCP server: what it does, how to install
An MCP server that gives an AI assistant Discord tools: post and read channel messages, handle forum posts, add reactions, manage webhooks.
no license updated 2026-10-29
Open on GitHubWhat Discord does
The server turns Discord actions into MCP tools. An assistant can sign the bot in, post into a channel, pull recent messages or delete one, list forum channels and open, read or remove posts, create and drop text channels, and touch reactions. Webhook tools go from creating a hook to sending a message through it, editing and deleting it.
This is a TypeScript project you build yourself: git clone https://github.com/barryyip0625/mcp-discord.git, then npm install and npm run build. Node.js 16.0.0 or newer and npm 7.0.0 or newer are required. The bot token sits in the DISCORD_TOKEN environment variable, or you hand it over as JSON via --config. Client configs point node at build/index.js; on Cursor the command is wrapped in cmd /c.
Grab the token from the Discord Developer Portal and switch on Message Content Intent, Server Members Intent and Presence Intent for that bot. Inside your server it needs rights to send messages, start and manage public threads, manage channels and add reactions. Without the token the tools never register, so there is nothing to call.
What it helps with
- post a release note to a channel without opening the Discord app
- pull recent channel messages into the assistant's context
- open a forum post and answer in its thread
- react to a message with one or several emoji
- create a webhook and push notifications through it
Example prompts for the agent
- Log the bot in and list the channels on my server
- Post to
#generalthat the deploy finished - Read the last messages in
#supportand list the questions nobody answered
How to install Discord
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Discord
How do I install the Discord MCP server in Claude Code?
Build it from source: git clone https://github.com/barryyip0625/mcp-discord.git, cd mcp-discord, npm install, npm run build. Then register it in your MCP config with the node command pointing at build/index.js and DISCORD_TOKEN set in env.
What does the Discord MCP server do?
It exposes Discord actions as tools: sending and reading messages, forum posts, channel creation and removal, reactions, and webhook management.
What do I need before running it?
Node.js 16.0.0 or newer, npm 7.0.0 or newer, and a bot token from the Discord Developer Portal. The bot needs Message Content Intent, Server Members Intent and Presence Intent enabled, plus message, thread, channel and reaction permissions in your server.