Skip to content
MCP server

Discord Tools

Read and send Discord messages from a coding agent using your own account, with ToS risk

Runs locallyStatus and history
Install
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-tools

Add to claude_desktop_config.json

{
  "mcpServers": {
    "discord-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@craftsamo/discord-tools"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "discord-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@craftsamo/discord-tools"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers