Discord RPC MCP README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Discord RPC MCP listing page.
discord-rpc-mcp
A server that exposes the Discord desktop app's RPC through MCP. (Functionality follows Discord's RPC capabilities, so features such as searching past chats are not available.)
Ask it to read a channel, receive new messages, or turn down someone's volume in a call.
What you can do
| Tools | Purpose |
|---|---|
get_guilds, get_guild, get_channels | Get server and channel information |
get_channel | Read a channel, DM or group DM |
get_selected_voice_channel, get_voice_settings | Check your voice channel and settings |
subscribe, unsubscribe, get_events | Subscribe to and read messages, voice events and more |
select_text_channel, select_voice_channel | Switch channels, join or leave a call |
set_voice_settings, set_user_voice_settings | Adjust your audio settings or another participant's local volume |
set_activity | Set or clear Rich Presence |
send_activity_join_invite, close_activity_request | Accept or reject activity join requests |
set_certified_devices | Set device information |
Get started
1. Install
Send this to an agent with terminal access, such as Codex or Claude Code:
For manual setup or Claude Desktop, see the installation guide.
2. Connect Discord
Complete the Discord settings below. Labels use the English interface. You can reuse an application you have already configured.
- Open the Discord Developer Portal and sign in
- Select
New Application> enter a name such asRPC MCP BridgeinName> review and accept the terms >Create - In the left menu, select
OAuth2>Redirects>Add Redirect> enterhttp://127.0.0.1:8765/callback>Save Changes - On the same
OAuth2page, selectClient ID>Copy, then paste it afterDISCORD_CLIENT_ID=in the local.envfile indicated by your agent - Copy
Client Secret, paste it afterDISCORD_CLIENT_SECRET=in the same file, and save- For a new application without an available secret, use
Reset Secretand complete any identity verification requested - Resetting an existing application's secret also requires updating any other integrations using it
- For a new application without an available secret, use
- Start the Discord desktop app on your computer and tell your agent that the configuration is saved and it can continue connecting
- When Discord shows an authorization prompt, check the application name and requested permissions, then approve
Enter the secret in the local .env file, not in chat. For manual login commands, see the installation guide.
Configuration · Development · Discord RPC access requirements
Notes
- Only reading is enabled by default. To change volume, switch channels or perform other actions, set
DISCORD_ALLOW_CONTROL=1in.env. See the configuration guide for the required authorization scopes - Messages are limited to what Discord has loaded. Full-history search and normal message sending, editing and deletion are not supported
- Reading messages may move the Discord view
- Retrieved content may be sent to your AI service
- Not affiliated with Discord