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
git clone https://github.com/virat-mankali/discord-cliThis 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
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_messageandsync_channelto theautoApprovearray in yourmcp.jsonif 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)
- Go to Discord Developer Portal
- Create application → Bot → Reset Token
- Enable Message Content Intent under Privileged Gateway Intents
- Invite bot to your server with
Read Messages,Send Messages,Read Message History,Attach Filespermissions
User Token (Personal Use)
- Open Discord in browser
- 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
- steipete/wacli — WhatsApp CLI by Peter Steinberger
- virat-mankali/telegram-cli — Telegram CLI
License
MIT
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.