discord-mcp
Manage a Discord server from your AI client through your own bot, with 100 tools
- Pricing
- Free
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 2.4.0
- Listing updated
- 2 days ago
About discord-mcp
discord-mcp is a free MCP server for communication. It runs locally on your machine and is started by your AI client.
The server connects an assistant to a Discord server through a bot you create, and the bot's Discord permissions are the ceiling on what it can do. The README describes 100 tools across messages, channels, permissions, members, roles, moderation, forums, webhooks, scheduled events, invites and DMs, with example asks such as summarising a busy channel, scheduling a community call or previewing a spam cleanup.
Because all 100 tools cost about 32k tokens of context, a DISCORD_MCP_TOOLSETS setting exposes only chosen groups; for example a chat profile with 25 tools is about 9k tokens. Read-only mode keeps just the 35 tools marked readOnlyHint. Bulk deletes, bulk bans, member prunes and channel deletion run as dry runs unless dry_run is false, and DISCORD_ALLOWED_GUILDS restricts calls to listed servers.
Setup needs a bot token, Server Members and Message Content intents, and Node.js 22 or later. It runs over stdio via npx, a Docker image or a Claude Desktop bundle, with one-click installs for VS Code and Cursor.
Install
Run in a terminal
claude mcp add discord-mcp --env DISCORD_TOKEN='<DISCORD_TOKEN>' --env DISCORD_MCP_HTTP_TOKEN='<DISCORD_MCP_HTTP_TOKEN>' -- npx -y @pasympa/discord-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"discord-mcp": {
"command": "npx",
"args": [
"-y",
"@pasympa/discord-mcp"
],
"env": {
"DISCORD_TOKEN": "<DISCORD_TOKEN>",
"DISCORD_MCP_HTTP_TOKEN": "<DISCORD_MCP_HTTP_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"discord-mcp": {
"command": "npx",
"args": [
"-y",
"@pasympa/discord-mcp"
],
"env": {
"DISCORD_TOKEN": "<DISCORD_TOKEN>",
"DISCORD_MCP_HTTP_TOKEN": "<DISCORD_MCP_HTTP_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"discord-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@pasympa/discord-mcp"
],
"env": {
"DISCORD_TOKEN": "<DISCORD_TOKEN>",
"DISCORD_MCP_HTTP_TOKEN": "<DISCORD_MCP_HTTP_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"discord-mcp": {
"command": "npx",
"args": [
"-y",
"@pasympa/discord-mcp"
],
"env": {
"DISCORD_TOKEN": "<DISCORD_TOKEN>",
"DISCORD_MCP_HTTP_TOKEN": "<DISCORD_MCP_HTTP_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"discord-mcp": {
"command": "npx",
"args": [
"-y",
"@pasympa/discord-mcp"
],
"env": {
"DISCORD_TOKEN": "<DISCORD_TOKEN>",
"DISCORD_MCP_HTTP_TOKEN": "<DISCORD_MCP_HTTP_TOKEN>"
}
}
}
}Configuration
DISCORD_TOKENDiscord bot tokenRequiredDISCORD_MCP_TOOLSETSComma-separated toolsets to expose: discovery, messages, channels, permissions, members, roles, moderation, screening, stats, forums, webhooks, scheduled_events, invites, dm, or all. An unknown name stops the server at startup.DISCORD_MCP_READ_ONLYSet to true to expose only the read-only tools of the selected toolsets: write tools are neither listed nor callable. Any value other than true/false, 1/0, yes/no or on/off stops the server at startup.DISCORD_ALLOWED_GUILDSComma-separated guild IDs the server may act on. Calls that target any other guild are rejected. Unset allows every guild.DISCORD_MESSAGE_CONTENTSet to false to stop requesting the Message Content privileged intent at connect time.DISCORD_GUILD_MEMBERSSet to false to stop requesting the Server Members privileged intent at connect time.DISCORD_MCP_TRANSPORTstdio, or http to serve Streamable HTTP on /mcp for remote clients such as the OpenAI Responses API, Codex or n8n. Any other value stops the server at startup.DISCORD_MCP_HTTP_TOKENBearer token every HTTP request must carry. Required when DISCORD_MCP_TRANSPORT is http: at least 32 characters from the RFC 6750 b64token alphabet, different from DISCORD_TOKEN. Generate one with openssl rand -hex 32.DISCORD_MCP_HTTP_HOSTAddress the HTTP server listens on when DISCORD_MCP_TRANSPORT is http. Keep 127.0.0.1 unless the server runs in a container.DISCORD_MCP_HTTP_PORTPort the HTTP server listens on when DISCORD_MCP_TRANSPORT is http.DISCORD_MCP_HTTP_ALLOWED_HOSTSComma-separated hostnames, without port, accepted in the Host header of HTTP requests besides localhost, 127.0.0.1 and [::1], such as the public name a reverse proxy forwards.DISCORD_TOKENDiscord bot tokenRequiredDISCORD_MCP_TOOLSETSComma-separated toolsets to expose: discovery, messages, channels, permissions, members, roles, moderation, screening, stats, forums, webhooks, scheduled_events, invites, dm, or all. An unknown name stops the server at startup.DISCORD_MCP_READ_ONLYSet to true to expose only the read-only tools of the selected toolsets: write tools are neither listed nor callable. Any value other than true/false, 1/0, yes/no or on/off stops the server at startup.DISCORD_ALLOWED_GUILDSComma-separated guild IDs the server may act on. Calls that target any other guild are rejected. Unset allows every guild.DISCORD_MESSAGE_CONTENTSet to false to stop requesting the Message Content privileged intent at connect time.DISCORD_GUILD_MEMBERSSet to false to stop requesting the Server Members privileged intent at connect time.DISCORD_MCP_TRANSPORTstdio, or http to serve Streamable HTTP on /mcp for remote clients such as the OpenAI Responses API, Codex or n8n. Any other value stops the server at startup.DISCORD_MCP_HTTP_TOKENBearer token every HTTP request must carry. Required when DISCORD_MCP_TRANSPORT is http: at least 32 characters from the RFC 6750 b64token alphabet, different from DISCORD_TOKEN. Generate one with openssl rand -hex 32.DISCORD_MCP_HTTP_HOSTAddress the HTTP server listens on when DISCORD_MCP_TRANSPORT is http. Keep 127.0.0.1 unless the server runs in a container.DISCORD_MCP_HTTP_PORTPort the HTTP server listens on when DISCORD_MCP_TRANSPORT is http.DISCORD_MCP_HTTP_ALLOWED_HOSTSComma-separated hostnames, without port, accepted in the Host header of HTTP requests besides localhost, 127.0.0.1 and [::1], such as the public name a reverse proxy forwards.
Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- discord_bulk_delete_messages
- Bulk-deletes messages; dry run by default.
- discord_bulk_ban
- Bans several members; dry run by default.
- discord_prune_members
- Prunes inactive members; dry run by default.
- discord_delete_channel
- Deletes a channel; dry run by default.
- discord_list_webhooks
- Lists webhooks, including their tokens.
- discord_read_dms
- Reads the bot's direct messages with a user.
What it does
- 100 tools
- Messages, roles, channels, forums, events, webhooks, invites and moderation.
- Toolset selection
- Load only the tool groups you need to save context.
- Dry runs
- Destructive bulk actions preview by default.
- Guild allowlist
- Restrict every call to chosen Discord servers.
- Read-only mode
- Expose only tools marked as read-only.
- Tool annotations
- Reads and destructive writes are flagged so clients can ask first.
Good for
- Summarise a busy channel and post a recap
- Preview and remove a spam raid
- Schedule an event and announce it
- Audit permission overwrites across the server
- Create an expiring invite for new members
Pricing
Free
Free to run with your own Discord bot.
discord-mcp FAQ
What can it do on my server?
Only what the bot's Discord permissions allow.
How do I cut the context cost?
Set DISCORD_MCP_TOOLSETS to the groups you need; the README shows a 25-tool profile at about 9k tokens.
Are destructive actions safe?
Bulk delete, bulk ban, prune and channel deletion run as dry runs unless dry_run is set to false.
What do I need installed?
Node.js 22 or later, or Docker, plus a bot token.
Is discord-mcp free?
Yes. discord-mcp is free to use.
How do I add discord-mcp to Claude Code?
Run this command in your terminal: claude mcp add discord-mcp --env DISCORD_TOKEN='<DISCORD_TOKEN>' --env DISCORD_MCP_HTTP_TOKEN='<DISCORD_MCP_HTTP_TOKEN>' -- npx -y @pasympa/discord-mcp
What are the best alternatives to discord-mcp?
The closest alternatives to discord-mcp are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.
Alternatives to discord-mcp

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

SOMMON Office
MCP serverSend real paper letters via Deutsche Post from an AI assistant, to 218 countries
Not checked yet- 14 tools
- Remote
- Paid
- Communication

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO

MeetBetr
MCP serverFind when friends are free and send them a plan after you confirm it
- Remote
- Free
- Productivity