Skip to main content
Glama
enesjakozh

Discord MCP Server

by v-3
npmGitHub
TypeScript
61
140
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Discord MCP Server

A Model Context Protocol (MCP) server that enables LLMs to interact with Discord channels, allowing them to send and read messages through Discord's API. Using this server, LLMs like Claude can directly interact with Discord channels while maintaining user control and security.

Features

  • Send messages to Discord channels

  • Read recent messages from channels

  • Automatic server and channel discovery

  • Support for both channel names and IDs

  • Proper error handling and validation

Prerequisites

  • Node.js 16.x or higher

  • A Discord bot token

  • The bot must be invited to your server with proper permissions:

    • Read Messages/View Channels

    • Send Messages

    • Read Message History

Setup

  1. Clone this repository:

git clone https://github.com/yourusername/discordmcp.git cd discordmcp

  1. Install dependencies:

npm install

  1. Create a .env file in the root directory with your Discord bot token:

DISCORD_TOKEN=your_discord_bot_token_here

  1. Build the server:

npm run build

Usage with Claude for Desktop

  1. Open your Claude for Desktop configuration file:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. Add the Discord MCP server configuration:

{ "mcpServers": { "discord": { "command": "node", "args": ["path/to/discordmcp/build/index.js"], "env": { "DISCORD_TOKEN": "your_discord_bot_token_here" } } } }

  1. Restart Claude for Desktop

Available Tools

send-message

Sends a message to a specified Discord channel.

Parameters:

  • server (optional): Server name or ID (required if bot is in multiple servers)

  • channel: Channel name (e.g., "general") or ID

  • message: Message content to send

Example:

{ "channel": "general", "message": "Hello from MCP!" }

read-messages

Reads recent messages from a specified Discord channel.

Parameters:

  • server (optional): Server name or ID (required if bot is in multiple servers)

  • channel: Channel name (e.g., "general") or ID

  • limit (optional): Number of messages to fetch (default: 50, max: 100)

Example:

{ "channel": "general", "limit": 10 }

Development

  1. Install development dependencies:

npm install --save-dev typescript @types/node

  1. Start the server in development mode:

npm run dev

Testing

You can test the server using the MCP Inspector:

npx @modelcontextprotocol/inspector node build/index.js

Examples

Here are some example interactions you can try with Claude after setting up the Discord MCP server:

  1. "Can you read the last 5 messages from the general channel?"

  2. "Please send a message to the announcements channel saying 'Meeting starts in 10 minutes'"

  3. "What were the most recent messages in the development channel about the latest release?"

Claude will use the appropriate tools to interact with Discord while asking for your approval before sending any messages.

Security Considerations

  • The bot requires proper Discord permissions to function

  • All message sending operations require explicit user approval

  • Environment variables should be properly secured

  • Token should never be committed to version control

  • Channel access is limited to channels the bot has been given access to

Contributing

  1. Fork the repository

  2. Create your feature branch (git checkout -b feature/amazing-feature)

  3. Commit your changes (git commit -m 'Add some amazing feature')

  4. Push to the branch (git push origin feature/amazing-feature)

  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

If you encounter any issues or have questions:

  1. Check the GitHub Issues section

  2. Consult the MCP documentation at https://modelcontextprotocol.io

  3. Open a new issue with detailed reproduction steps

This server cannot be installed

-
security - not tested
-
license - not tested
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables LLMs to interact with Discord channels by sending and reading messages through Discord's API, with a focus on maintaining user control and security.

  1. Features
    1. Prerequisites
      1. Setup
        1. Usage with Claude for Desktop
          1. Available Tools
            1. send-message
            2. read-messages
          2. Development
            1. Testing
              1. Examples
                1. Security Considerations
                  1. Contributing
                    1. License
                      1. Support

                        Related Resources

                        Related MCP Servers

                        • Discord Raw API MCP Server

                          hanweg
                          A
                          security
                          -
                          license
                          A
                          quality
                          Enables direct interaction with the Discord API using both REST API calls and slash command syntax for bot management, server configuration, and message operations.
                          Last updated -
                          8
                          MIT License

                        • Lightning Tools MCP Server

                          getAlby
                          A
                          security
                          -
                          license
                          A
                          quality
                          Enables interaction with lightning addresses and common lightning tools via your LLM, providing Lightning Network functionality through natural language.
                          Last updated -
                          3
                          12
                          1

                        • MCP-Discord

                          barryyip0625
                          A
                          security
                          -
                          license
                          A
                          quality
                          A Discord Model Context Protocol server that enables AI assistants to interact with Discord, providing functionality for sending messages, managing channels, handling forum posts, and working with reactions.
                          Last updated -
                          22
                          13
                          50
                          MIT License
                          • Linux
                          • Apple

                        • Discord MCP Server

                          henishshah18
                          -
                          security
                          -
                          license
                          -
                          quality
                          A secure server that enables interaction with Discord channels through JWT-authenticated API calls, allowing users to send messages, fetch channel data, search content, and perform moderation actions.
                          Last updated -

                        View all related MCP servers

                        Appeared in Searches

                        New MCP Servers

                        MCP directory API

                        We provide all the information about MCP servers via our MCP API.

                        curl -X GET 'https://glama.ai/api/mcp/v1/servers/v-3/discordmcp'

                        If you have feedback or need assistance with the MCP directory API, please join our Discord server