Discord MCP

1<div align="center">
2  <img src="assets/img/Discord_MCP_full_logo.svg" width="60%" alt="DeepSeek-V3" />
3</div>
4<hr>
5<div align="center" style="line-height: 1;">
6    <a href="https://github.com/modelcontextprotocol/servers" target="_blank" style="margin: 2px;">
7        <img alt="MCP Server" src="https://badge.mcpx.dev?type=server" style="display: inline-block; vertical-align: middle;"/>
8    </a>
9    <a href="https://discord.gg/5Uvxe5jteM" target="_blank" style="margin: 2px;">
10        <img alt="Discord" src="https://img.shields.io/discord/936242526120194108?color=7389D8&label&logo=discord&logoColor=ffffff" style="display: inline-block; vertical-align: middle;"/>
11    </a>
12    <a href="https://github.com/SaseQ/discord-mcp/blob/main/LICENSE" target="_blank" style="margin: 2px;">
13        <img alt="MIT License" src="https://img.shields.io/github/license/SaseQ/discord-mcp" style="display: inline-block; vertical-align: middle;"/>
14    </a>
15</div>
16 
17 
18## 📖 Description
19 
20A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) server for the Discord API [(JDA)](https://jda.wiki/), 
21allowing seamless integration of Discord Bot with MCP-compatible applications like Claude Desktop.
22 
23Enable your AI assistants to seamlessly interact with Discord. Manage channels, send messages, and retrieve server information effortlessly. Enhance your Discord experience with powerful automation capabilities.
24 
25 
26## 🔬 Installation
27 
28### ► 🐳 Docker Installation (Recommended)
29> NOTE: Docker installation is required. Full instructions can be found on [docker.com](https://www.docker.com/products/docker-desktop/).
30```json
31{
32  "mcpServers": {
33    "mcp-server": {
34      "command": "docker",
35      "args": [
36        "run", "--rm", "-i",
37        "-e", "DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN>",
38        "-e", "DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID>",
39        "saseq/discord-mcp:latest"
40      ]
41    }
42  }
43}
44```
45 
46<details>
47    <summary style="font-size: 1.35em; font-weight: bold;">
48        🔧 Manual Installation
49    </summary>
50 
51#### Clone the repository
52```bash
53git clone https://github.com/SaseQ/discord-mcp
54```
55 
56#### Build the project
57> NOTE: Maven installation is required to use the mvn command. Full instructions can be found [here](https://www.baeldung.com/install-maven-on-windows-linux-mac).
58```bash
59cd discord-mcp
60mvn clean package # The jar file will be available in the /target directory
61```
62 
63#### Configure AI client
64Many code editors and other AI clients use a configuration file to manage MCP servers.
65 
66The Discord MPC server can be configured by adding the following to your configuration file.
67 
68> NOTE: You will need to create a Discord Bot token to use this server. Instructions on how to create a Discord Bot token can be found [here](https://discordjs.guide/preparations/setting-up-a-bot-application.html#creating-your-bot).
69```json
70{
71  "mcpServers": {
72    "discord-mcp": {
73      "command": "java",
74      "args": [
75        "-jar",
76        "/absolute/path/to/discord-mcp-0.0.1-SNAPSHOT.jar"
77      ],
78      "env": {
79        "DISCORD_TOKEN": "YOUR_DISCORD_BOT_TOKEN",
80        "DISCORD_GUILD_ID": "OPTIONAL_DEFAULT_SERVER_ID"
81      }
82    }
83  }
84}
85```
86The `DISCORD_GUILD_ID` environment variable is optional. When provided, it sets a default Discord server ID so any tool that accepts a `guildId` parameter can omit it.
87 
88</details>
89 
90<details>
91    <summary style="font-size: 1.35em; font-weight: bold;">
92        🦞 OpenClaw Installation
93    </summary>
94 
95Run this command.
96```bash
97openclaw mcp add \
98  --name discord \
99  --transport stdio \
100  --command "docker" \
101  --args "run" \
102  --args "--rm" \
103  --args "-i" \
104  --args "-e" --args "DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN>" \
105  --args "-e" --args "DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID>" \
106  --args "saseq/discord-mcp:latest"
107```
108 
109OR
110 
111Pasting the following configuration into your OpenClaw `~/.openclaw/config.json` or `mcp_servers.json` file.
112```json
113{
114  "mcpServers": {
115    "mcp-server": {
116      "command": "docker",
117      "args": [
118        "run", "--rm", "-i",
119        "-e", "DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN>",
120        "-e", "DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID>",
121        "saseq/discord-mcp:latest"
122      ]
123    }
124  }
125}
126```
127 
128</details>
129 
130<details>
131    <summary style="font-size: 1.35em; font-weight: bold;">
132        🖲 Cursor Installation
133    </summary>
134 
135Go to: `Settings` -> `Cursor Settings` -> `MCP` -> `Add new global MCP server`
136 
137Pasting the following configuration into your Cursor `~/.cursor/mcp.json` file is the recommended approach. You may also install in a specific project by creating `.cursor/mcp.json` in your project folder. See [Cursor MCP docs](https://docs.cursor.com/context/model-context-protocol) for more info.
138```json
139{
140  "mcpServers": {
141    "mcp-server": {
142      "command": "docker",
143      "args": [
144        "run", "--rm", "-i",
145        "-e", "DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN>",
146        "-e", "DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID>",
147        "saseq/discord-mcp:latest"
148      ]
149    }
150  }
151}
152```
153 
154</details>
155 
156<details>
157    <summary style="font-size: 1.35em; font-weight: bold;">
158        ⌨️ Claude Code Installation
159    </summary>
160 
161Run this command. See [Claude Code MCP docs](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/tutorials#set-up-model-context-protocol-mcp) for more info.
162```bash
163claude mcp add mcp-server -- docker run --rm -i -e DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN> -e DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID> saseq/discord-mcp:latest
164```
165 
166</details>
167 
168## 🛠️ Available Tools
169 
170#### Server Information
171 - [`get_server_info`](): Get detailed discord server information
172 
173#### User Management
174- [`get_user_id_by_name`](): Get a Discord user's ID by username in a guild for ping usage `<@id>`
175- [`send_private_message`](): Send a private message to a specific user
176- [`edit_private_message`](): Edit a private message from a specific user
177- [`delete_private_message`](): Delete a private message from a specific user
178- [`read_private_messages`](): Read recent message history from a specific user
179 
180#### Message Management
181 - [`send_message`](): Send a message to a specific channel
182 - [`edit_message`](): Edit a message from a specific channel
183 - [`delete_message`](): Delete a message from a specific channel
184 - [`read_messages`](): Read recent message history from a specific channel
185 - [`add_reaction`](): Add a reaction (emoji) to a specific message
186 - [`remove_reaction`](): Remove a specified reaction (emoji) from a message
187 
188#### Channel Management
189 - [`create_text_channel`](): Create text a channel
190 - [`delete_channel`](): Delete a channel
191 - [`find_channel`](): Find a channel type and ID using name and server ID
192 - [`list_channels`](): List of all channels
193 
194#### Category Management
195 - [`create_category`](): Create a new category for channels
196 - [`delete_category`](): Delete a category
197 - [`find_category`](): Find a category ID using name and server ID
198 - [`list_channels_in_category`](): List of channels in a specific category
199 
200#### Webhook Management
201 - [`create_webhook`](): Create a new webhook on a specific channel
202 - [`delete_webhook`](): Delete a webhook
203 - [`list_webhooks`](): List of webhooks on a specific channel
204 - [`send_webhook_message`](): Send a message via webhook
205 
206#### Role Management
207 - [`list_roles`](): Get a list of all roles on the server with their details
208 - [`create_role`](): Create a new role on the server
209 - [`edit_role`](): Modify an existing role's settings
210 - [`delete_role`](): Permanently delete a role from the server
211 - [`assign_role`](): Assign a role to a user
212 - [`remove_role`](): Remove a role from a user
213 
214>If `DISCORD_GUILD_ID` is set, the `guildId` parameter becomes optional for all tools above.
215 
216<hr>
217 
218A more detailed examples can be found in the [Wiki](https://github.com/SaseQ/discord-mcp/wiki).
219