How to add Discord MCP Server (IQAI) to Claude Desktop

Discord MCP with messaging, forums, reactions, webhooks and sampling support Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 15, 2026 · 5★ · stdio · apikey

Claude Desktop config for Discord MCP Server (IQAI)

npx -y @iqai/mcp-discord --config <your-discord-bot-token>

{
  "mcpServers": {
    "discord-mcp-server-iqai": {
      "command": "npx",
      "args": [
        "-y",
        "@iqai/mcp-discord",
        "--config",
        "<your-discord-bot-token>"
      ],
      "env": {
        "DISCORD_TOKEN": "<your-discord-bot-token>"
      }
    }
  }
}

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the Discord MCP Server (IQAI) config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm Discord MCP Server (IQAI)'s tools appear under the 🔌 tools menu.

Before you start

Node.js (recent LTS recommended) with npx, or pnpm if building from source
A Discord application with a bot and its token, from the Discord Developer Portal
The Message Content, Server Members, and Presence privileged intents enabled for the bot
The bot invited to your server with appropriate permissions (Administrator recommended for full functionality)
An MCP client that supports the sampling capability, if you want the bot to auto-respond to mentions

What Discord MCP Server (IQAI) can do in Claude Desktop

discord_login

Authenticate the bot with the configured token

discord_get_server_info

Retrieve guild/server details

discord_send

Post a message to a text channel

discord_read_messages

Read messages from a channel (default limit 50)

discord_delete_message

Delete a specific message

discord_create_text_channel / discord_delete_channel

Create a text channel (optional topic) or delete a channel

discord_create_category / discord_edit_category / discord_delete_category

Create, edit (name/position), and delete categories

discord_get_forum_channels / discord_create_forum_post / discord_get_forum_post / discord_reply_to_forum / discord_delete_forum_post

List forums, create posts with optional tags, fetch a post, reply to threads, and delete posts

Security

A Discord bot token gives full bot access; scope the bot's gateway intents and server permissions tightly. Prefer the DISCORD_TOKEN env var over the --config flag to avoid the token appearing in process listings.

Discord MCP Server (IQAI) + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Discord MCP Server (IQAI) config there under the "mcpServers" key and restart the client.

Is Discord MCP Server (IQAI) safe to use with Claude Desktop?

What does the sampling feature do?

Sampling enables bi-directional communication: the bot listens for messages and, when mentioned, calls back to the host LLM to generate a reply automatically. It supports per-user rate limiting, message chunking, and optional AI-generated reactions, and requires an MCP client that implements the sampling capability.

How do I stop the bot from responding to everything?

By default RESPOND_TO_MENTIONS_ONLY is true and BLOCK_DMS is true, so it only reacts to mentions and ignores DMs. You can further restrict it with BLOCKED_GUILDS, BANNED_USERS, and DEFAULT_RATE_LIMIT_SECONDS.

Can I disable auto-responses entirely?

Yes. Set SAMPLING_ENABLED to false to turn off automatic mention responses while still using the explicit MCP tools.

View repo Full Discord MCP Server (IQAI) page