Discord Tools
Read and send Discord messages from a coding agent using your own account, with ToS risk
- Pricing
- Open source
- Platforms
- CLI, discord
- Runs
- Locally
- Version
- 1.3.0
- Listing updated
- today
Similar MCP servers
About Discord Tools
Discord Tools is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.
The README opens with a warning, and it matters more than any feature. These tools act from your own Discord account through the web client's API with your account token. Discord's terms forbid automating a user account, an account can be terminated for it even for read-only use, and whoever holds the token reads and writes as you, past password and second factor. It advises using an account you can afford to lose and doing only what you would do yourself.
The design mirrors Discord locally. A sync list controls which servers or named channels are followed, and reading tools query that mirror or Discord's own search. Visible tools cover account and sync health, adding and removing followed servers or channels, reading servers, channels, DMs and messages, and searching. The README also lists inbox, people and servers, history, files, sends, threads and roles. A skill accompanies each toolset, and a read-only flag turns writes off.
Plugin installs pinned to a release tag run on macOS (arm64, x64) and Linux (x64, arm64, glibc); npm installs run wherever the wreq-js binding exists. Harnesses include OpenCode, Claude Code, Codex, Grok Build, Antigravity and Hermes, and Node.js 24 or later is required.
Install
Run in a terminal
claude mcp add discord-tools -- npx -y @craftsamo/discord-toolsAdd to claude_desktop_config.json
{
"mcpServers": {
"discord-tools": {
"command": "npx",
"args": [
"-y",
"@craftsamo/discord-tools"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"discord-tools": {
"command": "npx",
"args": [
"-y",
"@craftsamo/discord-tools"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"discord-tools": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@craftsamo/discord-tools"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"discord-tools": {
"command": "npx",
"args": [
"-y",
"@craftsamo/discord-tools"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"discord-tools": {
"command": "npx",
"args": [
"-y",
"@craftsamo/discord-tools"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- discord_account_read
- Read local account, token and sync health.
- discord_sync_read
- Show the sync list and suggest changes.
- discord_sync_add
- Follow a server or named channels.
- discord_sync_remove
- Stop following a server or channels.
- discord_chat_read
- Read servers, channels, DMs and messages.
- discord_search_read
- Search the mirror or Discord's search.
What it does
- Local mirror
- Followed servers and channels are synced so reads and searches run against the mirror.
- Sync control
- Add or remove servers and named channels from the sync list.
- Message reading
- Read servers, channels, DMs and messages.
- Search
- Search the mirror or use Discord's own search.
- Skill per toolset
- Each toolset ships a skill that guides the agent.
- Read-only flag
- A flag disables sending and other writes.
Good for
- Search a server's history for a past decision
- Have an agent summarise a channel you follow
- Check which servers are syncing and their health
- Draft and send a reply you have approved
Pricing
Open source
Free npm package; uses your own Discord account.
More servers for the same service
Discord Tools FAQ
Is this safe for my Discord account?
The README warns that it breaks Discord's terms for user-account automation and the account can be terminated, so use one you can afford to lose.
What does it require?
Node.js 24 or later and your Discord account token.
Where does it run?
Plugin installs run on macOS and Linux; npm installs run wherever the wreq-js binding is available.
Can I limit it to reading?
Yes, use the --read-only flag.
Is Discord Tools free?
Yes. Discord Tools is open source, so you can use and self-host it for free.
How do I add Discord Tools to Claude Code?
Run this command in your terminal: claude mcp add discord-tools -- npx -y @craftsamo/discord-tools
What are the best alternatives to Discord Tools?
The closest alternatives to Discord Tools are TrendRadar, Getmitra, Discord, Zoom and Email Spam Tester.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

