# Discord Tools

> Discord Tools is an open-source MCP server for communication. Read and send Discord messages from a coding agent using your own account, with ToS risk. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, discord
- **Repository:** https://github.com/craft-agent/discord-tools
- **MCP Registry name:** io.github.craft-agent/discord-tools
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add discord-tools -- npx -y @craftsamo/discord-tools
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "discord-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@craftsamo/discord-tools"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "discord-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@craftsamo/discord-tools"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "discord-tools": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@craftsamo/discord-tools"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "discord-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@craftsamo/discord-tools"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "discord-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@craftsamo/discord-tools"
      ]
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [TrendRadar](https://ai-powered.com/mcp/trendradar): TrendRadar is an open-source MCP server for communication.
- [Getmitra](https://ai-powered.com/mcp/getmitra): Getmitra is an MCP server for communication.
- [Discord](https://ai-powered.com/mcp/discord-2): Discord is a freemium MCP server for communication.
- [Zoom](https://ai-powered.com/mcp/zoom): Zoom is a freemium MCP server for communication.
- [Email Spam Tester](https://ai-powered.com/mcp/email-spam-tester): Email Spam Tester is a free MCP server for communication.
- [Slack_connect](https://ai-powered.com/mcp/slack-connect): Slack_connect is a freemium MCP server for communication.
- [Postmark](https://ai-powered.com/mcp/postmark): Postmark is a freemium MCP server for communication.
- [Gmail](https://ai-powered.com/mcp/gmail-5): Gmail is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/discord-tools
