Agent Skills
› davepoon/buildwithclaude
› discord-automation
discord-automation
GitHub通过Rube MCP自动化Discord操作，支持消息发送、私聊、频道管理及角色管理。需先验证连接状态，调用工具前务必搜索最新Schema。适用于需要批量处理Discord服务器事务的场景。
Trigger Scenarios
用户要求在Discord频道或私信中发送消息
用户需要创建、分配或删除服务器角色
用户需要管理Discord频道或机器人配置
Install
npx skills add davepoon/buildwithclaude --skill discord-automation -g -y
SKILL.md
Frontmatter
{
"name": "discord-automation",
"category": "communication",
"requires": {
"mcp": [
"rube"
]
},
"description": "Automate Discord tasks via Rube MCP (Composio): messages, channels, roles, webhooks, reactions. Always search tools first for current schemas."
}
Discord Automation via Rube MCP
Automate Discord operations through Composio's Discord/Discordbot toolkits via Rube MCP.
Toolkit docs: composio.dev/toolkits/discord
Prerequisites
- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Discord connection via
RUBE_MANAGE_CONNECTIONSwith toolkitsdiscordanddiscordbot - Always call
RUBE_SEARCH_TOOLSfirst to get current tool schemas
Setup
Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
- Verify Rube MCP is available by confirming
RUBE_SEARCH_TOOLSresponds - Call
RUBE_MANAGE_CONNECTIONSwith toolkitdiscordbot(bot operations) ordiscord(user operations) - If connection is not ACTIVE, follow the returned auth link to complete Discord auth
- Confirm connection status shows ACTIVE before running any workflows
Core Workflows
1. Send Messages
When to use: User wants to send messages to channels or DMs
Tool sequence:
DISCORD_LIST_MY_GUILDS- List guilds the bot belongs to [Prerequisite]DISCORDBOT_LIST_GUILD_CHANNELS- List channels in a guild [Prerequisite]DISCORDBOT_CREATE_MESSAGE- Send a message [Required]DISCORDBOT_UPDATE_MESSAGE- Edit a sent message [Optional]
Key parameters:
channel_id: Channel snowflake IDcontent: Message text (max 2000 characters)embeds: Array of embed objects for rich contentguild_id: Guild ID for channel listing
Pitfalls:
- Bot must have SEND_MESSAGES permission in the channel
- High-frequency sends can hit per-route rate limits; respect Retry-After headers
- Only messages sent by the same bot can be edited
2. Send Direct Messages
When to use: User wants to DM a Discord user
Tool sequence:
DISCORDBOT_CREATE_DM- Create or get DM channel [Required]DISCORDBOT_CREATE_MESSAGE- Send message to DM channel [Required]
Key parameters:
recipient_id: User snowflake ID for DMchannel_id: DM channel ID from CREATE_DM
Pitfalls:
- Cannot DM users who have DMs disabled or have blocked the bot
- CREATE_DM returns existing channel if one already exists
3. Manage Roles
When to use: User wants to create, assign, or remove roles
Tool sequence:
DISCORDBOT_CREATE_GUILD_ROLE- Create a new role [Optional]DISCORDBOT_ADD_GUILD_MEMBER_ROLE- Assign role to member [Optional]DISCORDBOT_DELETE_GUILD_ROLE- Delete a role [Optional]DISCORDBOT_GET_GUILD_MEMBER- Get member details [Optional]DISCORDBOT_UPDATE_GUILD_MEMBER- Update member (roles, nick, etc.) [Optional]
Key parameters:
guild_id: Guild snowflake IDuser_id: User snowflake IDrole_id: Role snowflake IDname: Role namepermissions: Bitwise permission valuecolor: RGB color integer
Pitfalls:
- Role assignment requires MANAGE_ROLES permission
- Target role must be lower in hierarchy than bot's highest role
- DELETE permanently removes the role from all members
4. Manage Webhooks
When to use: User wants to create or use webhooks for external integrations
Tool sequence:
DISCORDBOT_GET_GUILD_WEBHOOKS/DISCORDBOT_LIST_CHANNEL_WEBHOOKS- List webhooks [Optional]DISCORDBOT_CREATE_WEBHOOK- Create a new webhook [Optional]DISCORDBOT_EXECUTE_WEBHOOK- Send message via webhook [Optional]DISCORDBOT_UPDATE_WEBHOOK- Update webhook settings [Optional]
Key parameters:
webhook_id: Webhook IDwebhook_token: Webhook secret tokenchannel_id: Channel for webhook creationname: Webhook namecontent/embeds: Message content for execution
Pitfalls:
- Webhook tokens are secrets; handle securely
- Webhooks can post with custom username and avatar per message
- MANAGE_WEBHOOKS permission required for creation
5. Manage Reactions
When to use: User wants to view or manage message reactions
Tool sequence:
DISCORDBOT_LIST_MESSAGE_REACTIONS_BY_EMOJI- List users who reacted [Optional]DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS- Remove all reactions [Optional]DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS_BY_EMOJI- Remove specific emoji reactions [Optional]DISCORDBOT_DELETE_USER_MESSAGE_REACTION- Remove specific user's reaction [Optional]
Key parameters:
channel_id: Channel IDmessage_id: Message snowflake IDemoji_name: URL-encoded emoji orname:idfor custom emojisuser_id: User ID for specific reaction removal
Pitfalls:
- Unicode emojis must be URL-encoded (e.g., '%F0%9F%91%8D' for thumbs up)
- Custom emojis use
name:idformat - DELETE_ALL requires MANAGE_MESSAGES permission
Common Patterns
Snowflake IDs
Discord uses snowflake IDs (64-bit integers as strings) for all entities:
- Guilds, channels, users, roles, messages, webhooks
Permission Bitfields
Permissions are combined using bitwise OR:
- SEND_MESSAGES = 0x800
- MANAGE_ROLES = 0x10000000
- MANAGE_MESSAGES = 0x2000
- ADMINISTRATOR = 0x8
Pagination
- Most list endpoints support
limit,before,afterparameters - Messages: max 100 per request
- Reactions: max 100 per request, use
afterfor pagination
Known Pitfalls
Bot vs User Tokens:
discordbottoolkit uses bot tokens;discorduses user OAuth- Bot operations are preferred for automation
Rate Limits:
- Discord enforces per-route rate limits
- Respect
Retry-Afterheaders on 429 responses
Quick Reference
| Task | Tool Slug | Key Params |
|---|---|---|
| List guilds | DISCORD_LIST_MY_GUILDS | (none) |
| List channels | DISCORDBOT_LIST_GUILD_CHANNELS | guild_id |
| Send message | DISCORDBOT_CREATE_MESSAGE | channel_id, content |
| Edit message | DISCORDBOT_UPDATE_MESSAGE | channel_id, message_id |
| Get messages | DISCORDBOT_LIST_MESSAGES | channel_id, limit |
| Create DM | DISCORDBOT_CREATE_DM | recipient_id |
| Create role | DISCORDBOT_CREATE_GUILD_ROLE | guild_id, name |
| Assign role | DISCORDBOT_ADD_GUILD_MEMBER_ROLE | guild_id, user_id, role_id |
| Delete role | DISCORDBOT_DELETE_GUILD_ROLE | guild_id, role_id |
| Get member | DISCORDBOT_GET_GUILD_MEMBER | guild_id, user_id |
| Update member | DISCORDBOT_UPDATE_GUILD_MEMBER | guild_id, user_id |
| Get guild | DISCORDBOT_GET_GUILD | guild_id |
| Create webhook | DISCORDBOT_CREATE_WEBHOOK | channel_id, name |
| Execute webhook | DISCORDBOT_EXECUTE_WEBHOOK | webhook_id, webhook_token |
| List webhooks | DISCORDBOT_GET_GUILD_WEBHOOKS | guild_id |
| Get reactions | DISCORDBOT_LIST_MESSAGE_REACTIONS_BY_EMOJI | channel_id, message_id, emoji_name |
| Clear reactions | DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS | channel_id, message_id |
| Test auth | DISCORDBOT_TEST_AUTH | (none) |
| Get channel | DISCORDBOT_GET_CHANNEL | channel_id |
Powered by Composio
Version History
- 502fc01 Current 2026-07-05 15:03
