discord-mcp

A personal MCP (Model Context Protocol) server that lets Claude read Discord message threads. Give Claude a Discord message URL and it can fetch the thread content directly.

What it does

Exposes a single read_discord_thread tool to Claude that:

• Fetches the anchor message and all subsequent messages in a channel thread
• Supports pagination for long threads via after_id and batch_size
• Skips system messages and embeds (empty-content messages)
• Returns structured data: author, timestamp, content, and pagination state

This uses your personal Discord account token, so it can read any server you're a member of — no bot invite required.

Obtaining your Discord auth token

Warning: Your user token is equivalent to your Discord password. Never share it or commit it to version control.

1. Open Discord in your browser (discord.com)
2. Open DevTools (F12 or Ctrl+Shift+I)
3. Go to the Network tab
4. In Discord, navigate to any channel or send any message to trigger a network request
5. Filter requests by XHR or search for messages
6. Click any request to discord.com/api/v9/ or discord.com/api/v10/
7. In the Request Headers section, find the Authorization header — its value is your token

Alternatively, in the Console tab you can run:

webpackChunkdiscord_app.push([[Math.random()],{},r=>{m=[];for(let c in r.c)m.push(r.c[c])}]);
m.find(m=>m?.exports?.default?.getToken).exports.default.getToken()

Copy the token value (no Bot prefix — that's only for bot accounts).

Setup

Prerequisites: Python 3.10+, uv

cd /path/to/discord-mcp
uv venv
uv pip install -r requirements.txt

Create a .env file (see .env.example):

DISCORD_USER_TOKEN=your_token_here

Testing

Run the unit tests:

.venv/bin/pytest

Run the smoke test with a real Discord URL:

.venv/bin/python smoke_test.py

Registering with Claude Code

Register the server globally so it's available in all your Claude Code sessions:

claude mcp add --scope user discord \
  /path/to/discord-mcp/.venv/bin/python \
  /path/to/discord-mcp/server.py

Verify it's connected:

claude mcp get discord

You should see Status ✔ Connected.

Registering with Codex

Register the server with Codex as a local stdio MCP server:

codex mcp add discord -- \
  /path/to/discord-mcp/.venv/bin/python \
  /path/to/discord-mcp/server.py

Verify that it is configured:

codex mcp get discord
codex mcp list

Restart Codex or open a new session after adding the server. In the Codex terminal UI, run /mcp to confirm that discord and its read_discord_thread tool are available.

Usage

Once registered, ask Claude or Codex things like:

"Read this Discord thread: https://discord.com/channels/123/456/789"

"Summarize the conversation starting at this message: https://discord.com/channels/..."

The assistant will call read_discord_thread and have access to the message content. For long threads, it can paginate by passing the returned last_id as after_id in subsequent calls.

How it works

• Uses Discord's REST API v10 with your user token
• Fetches the anchor message via ?around=<id>&limit=1 (the direct endpoint is bot-only)
• Paginates forward with ?after=<id>&limit=<batch_size>
• Runs as a stdio MCP server — Claude Code or Codex spawns it as a subprocess when needed