1. Conduid
  2. Search
  3. Discord CLI
MCP server · Search

Discord CLI

Discord CLI + MCP server that runs as your own user account — read, send, search, and manage any server/DM you belong to, no bot invite. Agent-native JSON/JSONL output, SQLite + FTS5 offline archive, stealth-aware headers, single Rust binary.

34Low

Scored 7 days ago · breakdown

About Discord CLI

Discord CLI is an MCP server in the Search category: discord CLI + MCP server that runs as your own user account — read, send, search, and manage any server/DM you belong to, no bot invite. Agent-native JSON/JSONL output, SQLite + FTS5 offline archive, stealth-aware headers, single Rust binary.

The repository has 6 stars and 0 forks.

Install

From source
git clone https://github.com/virat-mankali/discord-cli

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (6)

get_sync_statusShow sync status and message counts

Parameters not published.

list_channelsList channels in a server

Parameters not published.

list_guildsList all Discord servers

Parameters not published.

search_messagesFull-text search across synced messages

Parameters not published.

send_messageSend a message to a channel

Parameters not published.

sync_channelSync a channel's history

Parameters not published.

Ask AI

✦

Ask AI about Discord CLI

Powered by Claude · Grounded in docs

I know everything about Discord CLI. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

🎮 discocli — Discord CLI + MCP Server

Interact with Discord from your terminal. Built for developers and AI agents.

discocli sync --follow          # real-time message capture
discocli search "deployment"    # offline full-text search
discocli send --to "#general" --text "Build passed ✅"
discocli serve                  # start MCP server for AI agents

Install

Homebrew (macOS & Linux)

brew install virat-mankali/tap/discocli

Build from source

git clone https://github.com/virat-mankali/discord-cli
cd discord-cli
go build -o discocli ./cmd/discocli/

Quick Start

# 1. Authenticate (bot token or user token)
discocli auth

# 2. Sync messages
discocli sync

# 3. Search offline
discocli search "standup notes"

# 4. Send a message
discocli send --to "#general" --text "Hello from the terminal!"

Commands

Command Description
discocli auth Authenticate with Discord (bot or user token)
discocli whoami Show the currently authenticated user
discocli sync Sync message history to local SQLite database
discocli sync --follow Real-time sync via Discord Gateway
discocli search <query> Full-text search across synced messages
discocli send --to <target> --text <msg> Send message to channel, DM, or thread
discocli guilds List all servers you're in
discocli channels --guild <name> List channels in a server
discocli serve Start MCP server for AI agents

MCP Server (AI Agents)

Add to your mcp.json:

{
  "mcpServers": {
    "discocli": {
      "command": "discocli",
      "args": ["serve"],
      "env": {},
      "disabled": false,
      "autoApprove": [
        "search_messages",
        "list_guilds",
        "list_channels",
        "get_sync_status"
      ]
    }
  }
}

Available MCP Tools

Tool Description Auto-approve?
search_messages Full-text search across synced messages ✅
list_guilds List all Discord servers ✅
list_channels List channels in a server ✅
get_sync_status Show sync status and message counts ✅
send_message Send a message to a channel ❌
sync_channel Sync a channel's history ❌
  • You can optionally add send_message and sync_channel to the autoApprove array in your mcp.json if you want your AI agent to use them without confirmation. They're excluded by default since they perform write operations.

How It Works

  • Messages are synced from Discord into a local SQLite database with FTS5 full-text search
  • All searches are offline — fast and private
  • Incremental sync only fetches new messages on subsequent runs
  • The MCP server exposes the same functionality over stdio for AI agents
  • Pure Go binary, no CGO — works on all platforms

Token Setup

Bot Token (Recommended)

  1. Go to Discord Developer Portal
  2. Create application → Bot → Reset Token
  3. Enable Message Content Intent under Privileged Gateway Intents
  4. Invite bot to your server with Read Messages, Send Messages, Read Message History, Attach Files permissions

User Token (Personal Use)

  1. Open Discord in browser
  2. DevTools → Network → any API request → Authorization header

⚠️ Important: Bot tokens are always the safer choice. User tokens violate Discord's Terms of Service if used for automation at scale. They're fine for personal/local use and AI agents acting on your behalf, but bot tokens are more stable, officially supported, and won't risk your account. When in doubt, use a bot token.

Inspired By

License

MIT

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About Discord CLI

How do I install Discord CLI?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Discord CLI safe to use with an AI agent?

Its trust score is 34 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Discord CLI still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.