# discord-mcp

> discord-mcp is a free MCP server for communication. Manage a Discord server from your AI client through your own bot, with 100 tools. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Windows, Linux, discord
- **Repository:** https://github.com/pasympa/discord-mcp
- **MCP Registry name:** io.github.PaSympa/discord-mcp
- **Categories:** communication
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add discord-mcp --env DISCORD_TOKEN='<DISCORD_TOKEN>' --env DISCORD_MCP_HTTP_TOKEN='<DISCORD_MCP_HTTP_TOKEN>' -- npx -y @pasympa/discord-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "discord-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pasympa/discord-mcp"
      ],
      "env": {
        "DISCORD_TOKEN": "<DISCORD_TOKEN>",
        "DISCORD_MCP_HTTP_TOKEN": "<DISCORD_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "discord-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pasympa/discord-mcp"
      ],
      "env": {
        "DISCORD_TOKEN": "<DISCORD_TOKEN>",
        "DISCORD_MCP_HTTP_TOKEN": "<DISCORD_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "discord-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pasympa/discord-mcp"
      ],
      "env": {
        "DISCORD_TOKEN": "<DISCORD_TOKEN>",
        "DISCORD_MCP_HTTP_TOKEN": "<DISCORD_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "discord-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pasympa/discord-mcp"
      ],
      "env": {
        "DISCORD_TOKEN": "<DISCORD_TOKEN>",
        "DISCORD_MCP_HTTP_TOKEN": "<DISCORD_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/discord-mcp-2
