# Discord User Mcp

> Discord MCP server using user tokens. No bot setup required.

- **Type:** MCP server
- **Install:** `agentstack add mcp-olivier-motium-discord-user-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [olivier-motium](https://agentstack.voostack.com/s/olivier-motium)
- **Installs:** 0
- **Category:** [Communication](https://agentstack.voostack.com/c/communication)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [olivier-motium](https://github.com/olivier-motium)
- **Source:** https://github.com/olivier-motium/discord-user-mcp

## Install

```sh
agentstack add mcp-olivier-motium-discord-user-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# discord-user-mcp

Discord MCP server using **user tokens**. No bot setup, no Developer Portal, no intents — just your token and go.

Built for [Claude Code](https://claude.com/claude-code) and any MCP-compatible client.

## Why user tokens?

Every other Discord MCP server requires creating a bot application, configuring intents, and inviting the bot to your server. This one uses your existing Discord session — the same access you already have in the app.

**Trade-off:** Using user tokens for automation is against Discord's ToS. This is a personal tool for your own account on your own machine. Use responsibly.

## Setup

### 1. Get your Discord token

Your token is stored encrypted in the Discord app's local storage. You can find it by:

- Opening Discord in a browser → DevTools → Network tab → any request → `Authorization` header
- Or extracting it from the desktop app's LevelDB storage (macOS: `~/Library/Application Support/discord/Local Storage/leveldb/`)

### 2. Add to Claude Code

```bash
claude mcp add discord -e DISCORD_TOKEN=your-token-here -- node /path/to/discord-user-mcp/dist/index.js
```

With a default server:

```bash
claude mcp add discord \
  -e DISCORD_TOKEN=your-token-here \
  -e DISCORD_DEFAULT_GUILD=your-server-id \
  -- node /path/to/discord-user-mcp/dist/index.js
```

### 3. Build from source

```bash
git clone https://github.com/olivier-motium/discord-user-mcp.git
cd discord-user-mcp
npm install
npm run build
```

## Tools (14)

### Core

| Tool | Description |
|------|-------------|
| `discord_list_guilds` | List servers you're in |
| `discord_list_channels` | List channels grouped by category |
| `discord_read_messages` | Read channel history with pagination |
| `discord_send_message` | Send a message, optionally as a reply |
| `discord_search` | **Search messages** by content, author, channel, date, attachment type |

### Essential

| Tool | Description |
|------|-------------|
| `discord_list_dms` | List DM conversations |
| `discord_send_dm` | Send a DM (by user ID or channel ID) |
| `discord_react` | Add emoji reaction to a message |
| `discord_pinned_messages` | Get pinned messages from a channel |
| `discord_list_threads` | List active threads in a server |
| `discord_guild_info` | Server details, roles, features |

### Additional

| Tool | Description |
|------|-------------|
| `discord_edit_message` | Edit your own message |
| `discord_delete_message` | Delete your own message |
| `discord_user_info` | User profile with server roles |

## Configuration

| Environment Variable | Required | Description |
|---------------------|----------|-------------|
| `DISCORD_TOKEN` | Yes | Your Discord user token |
| `DISCORD_DEFAULT_GUILD` | No | Default server ID — tools that need a guild will use this when not specified |

## Design choices

- **Plain text output** — no raw JSON. Messages formatted as `[2024-01-15 14:32] alice: content`. IDs always inline for tool chaining.
- **No discord.js** — raw `fetch` against Discord API v10. Zero runtime deps beyond MCP SDK.
- **Rate limit handling** — automatic retry with `retry_after` + jitter, up to 3 attempts.
- **Search is the star** — accepts usernames (resolved to IDs internally), date strings (`YYYY-MM-DD` converted to snowflakes), and all Discord search filters.
- **Conservative defaults** — 25 messages per read, not 100. Keeps output manageable for AI.

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [olivier-motium](https://github.com/olivier-motium)
- **Source:** [olivier-motium/discord-user-mcp](https://github.com/olivier-motium/discord-user-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-olivier-motium-discord-user-mcp
- Seller: https://agentstack.voostack.com/s/olivier-motium
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.