@taeraekim/discord-mcp

A Model Context Protocol (MCP) server for the Discord API using discord.js v14. Provides 37 tools for managing Discord servers, channels, messages, users, roles, and more — all accessible from MCP-compatible clients like Claude Desktop, Claude Code, and Cursor.

Quick Start

claude mcp add discord-mcp \
  -e DISCORD_TOKEN=your_token \
  -e DISCORD_GUILD_ID=your_guild_id \
  -- npx -y @taeraekim/discord-mcp

On Windows, prefix with cmd /c: -- cmd /c npx -y @taeraekim/discord-mcp

Installation

Claude Code

# macOS / Linux
claude mcp add discord-mcp -e DISCORD_TOKEN=your_token -e DISCORD_GUILD_ID=your_guild_id -- npx -y @taeraekim/discord-mcp

# Windows
claude mcp add discord-mcp -e DISCORD_TOKEN=your_token -e DISCORD_GUILD_ID=your_guild_id -- cmd /c npx -y @taeraekim/discord-mcp

Verify with claude mcp list.

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@taeraekim/discord-mcp"],
      "env": {
        "DISCORD_TOKEN": "your_token",
        "DISCORD_GUILD_ID": "your_guild_id"
      }
    }
  }
}

On Windows, use "command": "cmd" with "args": ["/c", "npx", "-y", "@taeraekim/discord-mcp"].

Cursor

Add to ~/.cursor/mcp.json or .cursor/mcp.json in your project:

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@taeraekim/discord-mcp"],
      "env": {
        "DISCORD_TOKEN": "your_token",
        "DISCORD_GUILD_ID": "your_guild_id"
      }
    }
  }
}

Docker

docker run --rm -i \
  -e DISCORD_TOKEN=your_token \
  -e DISCORD_GUILD_ID=your_guild_id \
  taerae/discord-mcp:latest

From Source

git clone https://github.com/TaeRaeKim/discord-mcp.git
cd discord-mcp
npm install
cp .env.example .env   # edit .env with your token
npm run build
npm start

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | DISCORD_TOKEN | Yes | Discord bot token | | DISCORD_GUILD_ID | No | Default guild ID. When set, guildId becomes optional for all tools |

Tools

Server Info (1)

| Tool | Description | |------|-------------| | get_server_info | Get detailed server information |

Messages (6)

| Tool | Description | |------|-------------| | send_message | Send a message to a text channel | | edit_message | Edit an existing message | | delete_message | Delete a message | | read_messages | Read message history from a channel | | add_reaction | Add an emoji reaction to a message | | remove_reaction | Remove the bot's emoji reaction |

Users & DM (5)

| Tool | Description | |------|-------------| | get_user_id_by_name | Find a user's ID by username | | send_private_message | Send a DM to a user | | edit_private_message | Edit a DM sent by the bot | | delete_private_message | Delete a DM sent by the bot | | read_private_messages | Read DM history with a user |

Channels (4)

| Tool | Description | |------|-------------| | create_channel | Create a new channel (text, voice, announcement, stage, or forum) | | delete_channel | Delete a channel | | find_channel | Find a channel by name | | list_channels | List all channels in the server |

Categories (4)

| Tool | Description | |------|-------------| | create_category | Create a new category | | delete_category | Delete a category | | find_category | Find a category by name | | list_channels_in_category | List channels in a category |

Webhooks (4)

| Tool | Description | |------|-------------| | create_webhook | Create a webhook on a channel | | delete_webhook | Delete a webhook | | list_webhooks | List webhooks on a channel | | send_webhook_message | Send a message via webhook |

Threads (1)

| Tool | Description | |------|-------------| | list_active_threads | List active threads in the server |

Roles (6)

| Tool | Description | |------|-------------| | list_roles | List all roles in the server | | create_role | Create a new role | | edit_role | Edit an existing role | | delete_role | Delete a role | | assign_role | Assign a role to a user | | remove_role | Remove a role from a user |

Pins (3)

| Tool | Description | |------|-------------| | pin_message | Pin a message in a text channel | | unpin_message | Unpin a message in a text channel | | list_pinned_messages | List all pinned messages in a channel |

Permissions (3)

| Tool | Description | |------|-------------| | set_channel_permission | Set permission overwrite for a role or member on a channel | | remove_channel_permission | Remove a permission overwrite from a channel | | get_channel_permissions | Get all permission overwrites for a channel |

Documentation

• Setup Guide — Bot creation, environment setup, and detailed configuration
• Tools Reference — Full parameter reference for all 37 tools

License

MIT