← All examples

Discord Tool

MCP tool that sends messages, manages channels, and interacts with Discord servers using OAuth. Connect Discord and communicate from any agent.

tooldiscordoauthmessagingmcp
Deploy this example

An MCP tool that connects to Discord via OAuth. Send messages, list channels, and manage servers — all callable by any agent or MCP client.

What's included

  • OAuth connection — connects to Discord via Reminix managed OAuth
  • Send messages — post to channels or send DMs
  • List channels — discover available channels in a server
  • Manage server — interact with guild and channel settings
  • MCP server — discoverable and callable by any agent or MCP client

When to use this

Pick the Discord Tool example when you want to:

  • Build an agent that posts notifications or alerts to Discord
  • Create a conversational agent that bridges Discord and other services
  • Learn how OAuth connections work with Discord's API

How connections work

Reminix handles the Discord OAuth flow, token exchange, and automatic refresh. Your tool handler receives a valid bot token and uses the Discord API directly.

  1. Create a Discord application and add OAuth credentials in the Reminix dashboard
  2. Authorize the connection to your server
  3. Your tool gets a fresh bot token on every call

Project structure

├── tools/
│   ├── send_message.py        # Send a message to a channel
│   └── list_channels.py       # List server channels
├── main.py                    # Entry point with serve()
├── pyproject.toml
└── reminix.config.toml

Quick start

After deploying and connecting your Discord server, any agent in your project can send messages and interact with Discord automatically.