Skip to main content
Glama
Sign In
Discord MCP Server

Discord MCP Server

by BennettSchwartz
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Discord MCP Server

A Model Context Protocol server that provides AI agents with secure access to Discord's REST API and Gateway events.

Features

🔧 120+ Discord API Tools - Complete coverage of Discord's REST API
🔒 Security First - Guild/channel allowlists, safe defaults, no accidental mentions
⚡ Real-time Events - Gateway integration for live Discord activity
🎯 Smart Routing - Auto-generated tools from declarative API catalog
📦 Modular Packs - Enable only the functionality you need

Related MCP server: discord-mcp

Quick Start

# Clone and install
git clone https://github.com/GustyCube/discord-mcp
cd discord-mcp
npm install

# Configure your bot
cp .env.example .env
# Add your DISCORD_BOT_TOKEN and other settings

# Build and run
npm run build
npm start

Documentation

📖 Complete documentation available at discord-mcp.gustycube.com

Quick Links

Example: Claude Desktop Integration

Add to your mcp.json:

{
  "mcpServers": {
    "discord": {
      "command": "node",
      "args": ["/path/to/discord-mcp/dist/index.js"],
      "env": {
        "DISCORD_BOT_TOKEN": "your_bot_token_here",
        "ALLOW_GUILD_IDS": "123456789,987654321",
        "ALLOW_CHANNEL_IDS": "111111111,222222222"
      }
    }
  }
}

What You Can Do

  • 📝 Message Management - Send, edit, delete messages and reactions

  • 👥 User & Guild Info - Get user profiles, guild details, member lists

  • 🔊 Channel Operations - List channels, manage permissions, create threads

  • 🎭 Rich Content - Send embeds, manage webhooks, upload files

  • ⚡ Live Events - Subscribe to message events, member joins, etc.

  • 🛡️ Moderation - Manage bans, kicks, roles (with appropriate permissions)

Contributing

See the full documentation for development setup, API reference, and contribution guidelines.

License

MIT License - see LICENSE file for details.

Available Tools

19 tools
discord_add_friendB

Send a friend request to a user

Inputs: no named parameters.

discord_add_reactionC

Add a reaction to a message

Inputs: channelId (required), messageId (required), emoji (required).

discord_cleanup_downloadC

Clean up a previously downloaded Discord attachment file

Inputs: path (required).

discord_clear_presenceB

Clear your Discord presence/activity

Inputs: no named parameters.

discord_create_dmC

Create or get existing DM channel with a user

Inputs: userId (required).

discord_delete_messageC

Delete a message

Inputs: channelId (required), messageId (required).

discord_download_attachmentB

Download a Discord attachment and return it as MCP file reference

Inputs: url (required).

discord_edit_messageC

Edit a previously sent message

Inputs: channelId (required), messageId (required), content (required).

discord_get_channelB

Get information about a Discord channel

Inputs: channelId (required).

discord_get_dm_channelsB

Get list of DM channels for the current user

Inputs: no named parameters.

discord_get_friendsB

Get list of friends for the current user

Inputs: no named parameters.

discord_get_messageB

Get a specific message by ID with full attachment details

Inputs: channelId (required), messageId (required).

discord_get_message_historyC

Get message history from a Discord channel with optional filtering

Inputs: channelId (required), limit, before, after, +1 more.

discord_list_attachmentsC

List all attachments in a Discord channel from recent messages

Inputs: channelId (required), limit, imageOnly, minSize, +1 more.

discord_remove_friendC

Remove a friend or cancel a friend request

Inputs: userId (required).

discord_remove_reactionC

Remove a reaction from a message

Inputs: channelId (required), messageId (required), emoji (required), userId.

discord_search_messagesC

Search for messages in a Discord channel with text query and filters

Inputs: channelId (required), query (required), limit, authorId, +5 more.

discord_send_messageC

Send a message to a Discord channel, optionally with up to 10 files

Inputs: channelId (required), content, files, tts, +1 more.

discord_update_presenceB

Update your Discord presence/status

Inputs: status, activity, afk.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    A3.6/5.0

    Scored across 19 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no ambiguity, as they target specific Discord actions like friend management, message handling, channel operations, and presence updates. The descriptions clearly differentiate between similar actions, such as discord_add_friend vs discord_remove_friend or discord_send_message vs discord_edit_message, ensuring agents can easily select the correct tool.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with the prefix 'discord_', such as discord_add_friend, discord_edit_message, and discord_get_channel. This uniformity makes the tools predictable and easy to understand, with no deviations in naming conventions across the set.

    Tool Count5/5

    With 19 tools, the server is well-scoped for Discord interactions, covering a comprehensive range of actions from messaging and reactions to friend management and presence updates. Each tool earns its place by addressing specific needs without redundancy, making the count appropriate for the domain.

    Completeness5/5

    The tool set provides complete coverage for Discord operations, including CRUD actions for messages (send, edit, delete, get), friends (add, remove, list), channels (get, DM creation), and presence (update, clear). There are no obvious gaps, as it supports core workflows like attachment handling, message history, and search, ensuring agents can perform all essential tasks.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • discord-mcp

      taka392
      A
      license
      A
      quality
      D
      maintenance
      MCP server for interacting with Discord via REST API, enabling guild, channel, and message operations using a bot token.
      7
      MIT

    • discord-mcp

      chenzhaoxuan0
      A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for Discord communications, enabling listing guilds and channels, reading and sending messages, creating threads, and adding reactions.
      MIT

    • discord-mcp

      yone-k
      A
      license
      B
      quality
      D
      maintenance
      Enables MCP clients to interact with Discord servers, allowing operations such as sending messages and reading message history through the Discord API.
      23
      190 npm
      MIT