Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
idanbeck avatar

Discord Skill

  • 19 installs
  • 12 repo stars
  • Updated August 4, 2026
  • idanbeck/claude-skills

Send messages, read channels, and manage Discord servers with bot or user authentication.

About

A skill that sends messages, reads channels, and manages Discord servers via bot or user auth. A developer uses it to automate Discord messaging and monitoring.

  • Bot and user authentication
  • Requires explicit confirmation before sending messages

Discord Skill by the numbers

  • 19 all-time installs (skills.sh)
  • +1 installs in the week ending Aug 2, 2026 (Skillselion tracking)
  • Ranked #1,308 of 2,715 Automation & Workflows skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/idanbeck/claude-skills --skill discord-skill

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs19
repo stars12
Last updatedAugust 4, 2026
Repositoryidanbeck/claude-skills

What it does

Send messages, read channels, and manage Discord servers with bot or user authentication.

Files

SKILL.mdMarkdownGitHub ↗

Discord Skill - Server Messaging & Management

Send messages, read channels, and interact with Discord servers.

CRITICAL: Message Confirmation Required

Before sending ANY Discord message, you MUST get explicit user confirmation.

When the user asks to send a message: 1. First, show them the complete message details:

  • Account/bot being used
  • Channel or user (for DMs)
  • Full message text

2. Ask: "Do you want me to send this Discord message?" 3. ONLY run the send command AFTER the user explicitly confirms 4. NEVER send without confirmation

First-Time Setup

Option 1: Bot Token (Recommended)

Best for server automation:

1. Go to Discord Developer Portal 2. Click "New Application" → Name it 3. Go to "Bot" section:

  • Click "Reset Token" and copy the token
  • Enable "Message Content Intent" under Privileged Gateway Intents

4. Create credentials.json:

   {
     "client_id": "YOUR_APP_CLIENT_ID",
     "client_secret": "YOUR_APP_CLIENT_SECRET",
     "bot_token": "YOUR_BOT_TOKEN"
   }

Save to: ~/.claude/skills/discord-skill/credentials.json

5. Invite bot to your server:

  • OAuth2 → URL Generator
  • Select scopes: bot
  • Select permissions: Send Messages, Read Message History, Add Reactions
  • Copy URL and open in browser to invite

6. Authenticate:

   python3 ~/.claude/skills/discord-skill/discord_skill.py login --bot

Option 2: User OAuth2

For user account access (limited by Discord ToS):

1. Same app setup as above 2. Add redirect URL: http://localhost:9997 3. Run:

   python3 ~/.claude/skills/discord-skill/discord_skill.py login

4. Authorize in browser

Commands

Account Management

# List accounts
python3 ~/.claude/skills/discord-skill/discord_skill.py accounts

# Login with bot token
python3 ~/.claude/skills/discord-skill/discord_skill.py login --bot [--account NAME]

# Login with OAuth (user)
python3 ~/.claude/skills/discord-skill/discord_skill.py login [--account NAME]

# Logout
python3 ~/.claude/skills/discord-skill/discord_skill.py logout [--account NAME]

User & Server Info

# Get current user/bot info
python3 ~/.claude/skills/discord-skill/discord_skill.py me [--account NAME]

# List servers
python3 ~/.claude/skills/discord-skill/discord_skill.py guilds [--account NAME]

# List channels in a server
python3 ~/.claude/skills/discord-skill/discord_skill.py channels GUILD_ID [--account NAME]

# List server members
python3 ~/.claude/skills/discord-skill/discord_skill.py members GUILD_ID [--limit N] [--account NAME]

Messages (Requires Confirmation)

# Send message to channel
python3 ~/.claude/skills/discord-skill/discord_skill.py send CHANNEL_ID "message" [--account NAME]

# Read messages from channel
python3 ~/.claude/skills/discord-skill/discord_skill.py messages CHANNEL_ID [--limit N] [--account NAME]

# Reply to a message
python3 ~/.claude/skills/discord-skill/discord_skill.py reply CHANNEL_ID MESSAGE_ID "reply text" [--account NAME]

# Send direct message
python3 ~/.claude/skills/discord-skill/discord_skill.py dm USER_ID "message" [--account NAME]

# Search messages in server
python3 ~/.claude/skills/discord-skill/discord_skill.py search GUILD_ID "query" [--account NAME]

Reactions

# Add reaction to message
python3 ~/.claude/skills/discord-skill/discord_skill.py react CHANNEL_ID MESSAGE_ID "👍" [--account NAME]

Finding IDs

Discord uses snowflake IDs. Enable Developer Mode to copy them:

1. User Settings → Advanced → Developer Mode: ON 2. Right-click any server/channel/message/user → "Copy ID"

Or use the skill commands:

  • guilds → lists server IDs
  • channels GUILD_ID → lists channel IDs
  • messages CHANNEL_ID → lists message IDs

Examples

Send a Message

# Get server list
python3 ~/.claude/skills/discord-skill/discord_skill.py guilds

# Get channels in server
python3 ~/.claude/skills/discord-skill/discord_skill.py channels 123456789012345678

# Send message
python3 ~/.claude/skills/discord-skill/discord_skill.py send 987654321098765432 "Hello from Claude!"

Read Recent Messages

python3 ~/.claude/skills/discord-skill/discord_skill.py messages 987654321098765432 --limit 10

Reply to Someone

python3 ~/.claude/skills/discord-skill/discord_skill.py reply 987654321098765432 111222333444555666 "Thanks for the info!"

React to a Message

python3 ~/.claude/skills/discord-skill/discord_skill.py react 987654321098765432 111222333444555666 "🎉"

Bot vs User Authentication

FeatureBotUser (OAuth)
Send messages
Read messagesLimited
Server management
Multiple servers
Rate limitsHigherLower
ToS complianceGray area

Recommendation: Use bot tokens for automation.

Output

All commands output JSON for easy parsing.

Requirements

  • Python 3.9+
  • pip install requests

Bot Permissions

When inviting your bot, select these permissions:

  • Send Messages - Post in channels
  • Read Message History - Read past messages
  • Add Reactions - React to messages
  • View Channels - See channel list

For more features:

  • Manage Messages - Delete/pin messages
  • Embed Links - Rich embeds
  • Attach Files - Upload files

Security Notes

  • Message confirmation required - Claude must confirm before sending
  • Bot tokens grant full bot access - keep credentials.json secure
  • Tokens stored in ~/.claude/skills/discord-skill/tokens/
  • Revoke bot tokens in Developer Portal if compromised

Rate Limits

Discord has strict rate limits:

  • ~5 messages per 5 seconds per channel
  • ~10 reactions per 10 seconds
  • Bots get higher limits than users

The skill doesn't auto-retry on rate limits - space out bulk operations.

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.