betterdiscord-mcp MCP Server

An MCP server that lets an AI agent (like Claude) read data from Discord servers through your own account. It pairs with a BetterDiscord plugin, so the Python side never handles your token — data is…

Local serverstdio

What is the betterdiscord-mcp Server?

betterdiscord-mcp is an MCP project maintained in the encryrose/betterdiscord-mcp repository. The maintainer describes its purpose as “An MCP server that lets an AI agent (like Claude) read data from Discord servers through your own account. It pairs with a BetterDiscord plugin…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using uv. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
bridge_statusCheck whether the plugin is connected
pingLightweight health check: plugin version + resolved-module map
diagnosticsShow which internal Discord modules resolved (debugging)
list_guildsList servers the client can see
list_channelsList a server's text channels
get_messagesRead a channel's history (paginate with before; filter by author_id / after; humanize resolves mentions)
search_messagesNative Discord search across a server
search_localOffline full-text search (SQLite FTS5) over exports/.json
get_message_by_linkFetch a single message from a Discord message link
get_reactionsList users who reacted to a message with a given emoji
list_dmsList the account's direct and group DMs
list_threadsList threads or forum posts (loads uncached forum posts; includes first_message)
list_threads_paginatedPaginated threads/forum posts (offset/limit, returns {threads, hasMore, total})
read_threadRead a thread / forum post's messages in chronological order
get_pinsList a channel's or thread's pinned messages
get_channel_infoMetadata for a channel or thread
get_guild_infoGuild metadata: roles, channels, member count, features, boost tier
resolve_idClassify any snowflake as guild/channel/thread/user/message
list_membersMembers currently known to the client (resolve_role_names adds role names)
get_rolesList a guild's roles (id, name, color, position, permissions)
get_user_infoLook up a user by id
export_channelDump a channel's history to exports/.json
export_attachmentsDownload a channel's attachments to exports/ with a manifest
download_attachmentDownload a single Discord CDN attachment to exports/
channel_statsOffline analytics from a channel export (per-user, timeline, reply graph)

How to install the betterdiscord-mcp Server

{
  "mcpServers": {
    "discord": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/betterdiscord-mcp",
        "run",
        "discord-mcp"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.