Discord MCP Server 🤖💬

A lightweight, zero-external-dependency Model Context Protocol (MCP) server for interacting with Discord through AI assistants like Google Antigravity, Claude Desktop, Cursor, and other MCP-compliant clients.

✨ Features

• 💬 Messages: Read recent chat history, send messages, reply to threads/messages, edit and delete messages.

• 🏢 Servers & Guilds: List servers the bot belongs to, inspect member lists, roles, and guild details.

• 📁 Channels & Categories: Inspect channels, channel topics, and message metadata.

• 🧵 Threads: Create and participate in channel threads.

• 📌 Pins: Read, add, and remove pinned messages.

• 👍 Reactions: Add and remove reactions with unicode and custom emojis.

• 🚀 Zero External Dependencies: Built entirely with Python's standard library (urllib, json).

Related MCP server: poke_discord

🛠️ Tool Reference

🚀 Quickstart & Configuration

1. Prerequisites

• Python 3.10+

• A Discord Bot Token (obtain one from the Discord Developer Portal).

  • Ensure your bot has appropriate permissions (e.g. Read Messages/View Channels, Send Messages, Read Message History, Add Reactions, etc.).

2. Installation & Running

Clone the repository:

git clone https://github.com/swaritsoni6-lgtm/discord-mcp-server.git
cd discord-mcp-server

Set your token and run:

export DISCORD_BOT_TOKEN="your-bot-token-here"
python3 server.py

⚙️ Client Configurations

Antigravity / Gemini CLI (~/.gemini/config/mcp_config.json)

{
  "mcpServers": {
    "discord": {
      "command": "python3",
      "args": ["/path/to/discord-mcp-server/server.py"],
      "env": {
        "DISCORD_BOT_TOKEN": "your-bot-token-here"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "discord": {
      "command": "python3",
      "args": ["/path/to/discord-mcp-server/server.py"],
      "env": {
        "DISCORD_BOT_TOKEN": "your-bot-token-here"
      }
    }
  }
}

📄 License

MIT License