# discord-automation

discord-automation automates Discord messaging, roles, webhooks, and reactions using Rube MCP and Composio toolkits. It lets AI coding agents manage Discord channels and bot workflows directly.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 128 installs · ★ 3785 repo stars
- Author: davepoon
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/all-skills/skills/discord-automation/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/discord-automation

## What it does

This skill instructs coding agents on coordinating Discord operations through Rube MCP and Composio. The agent searches active schemas using `RUBE_SEARCH_TOOLS`, triggers bot or user connections via `RUBE_MANAGE_CONNECTIONS`, and runs actions targeting Discord snowflake identifiers.

Workflows cover posting text messages up to 2000 characters, formatting embeds, opening DM channels, provisioning webhooks, and adjusting member roles using bitwise permissions. Modifying roles or deleting reactions requires the bot to possess `MANAGE_ROLES` or `MANAGE_MESSAGES` permissions on the target guild.

Without adding `https://rube.app/mcp` to your MCP configuration and confirming an active Discord link, no Discord action will run. Operations must also handle per-route rate limits and parse `Retry-After` response headers on 429 status codes.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill discord-automation -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/discord-automation/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/discord-automation/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill discord-automation -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/discord-automation/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill discord-automation -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/discord-automation/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davepoon/buildwithclaude plugins/all-skills/skills/discord-automation
```

2. **Manually: put the files in place**
- File: `.github/skills/discord-automation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill discord-automation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/davepoon/buildwithclaude --path plugins/all-skills/skills/discord-automation
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/discord-automation/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill discord-automation -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/all-skills/skills/discord-automation/SKILL.md

## When to use it
- deliver messages and embeds to Discord guild channels
- create, delete, and assign guild roles to members
- generate and trigger webhooks for external tools
- open direct message threads with specified users
- inspect and remove message emoji reactions

## Example prompts
- Send an announcement to Discord channel 123456789012345678 using the bot
- Create a QA role on the guild and assign it to the given user ID
- List all webhooks in the channel and create a new one for alerts

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 33b7606071bdd9a2.

BEGIN THIRD-PARTY FILE 33b7606071bdd9a2
```text
---
name: discord-automation
description: "Automate Discord tasks via Rube MCP (Composio): messages, channels, roles, webhooks, reactions. Always search tools first for current schemas."
requires:
  mcp: [rube]
category: communication
---

# Discord Automation via Rube MCP

Automate Discord operations through Composio's Discord/Discordbot toolkits via Rube MCP.

**Toolkit docs**: [composio.dev/toolkits/discord](https://composio.dev/toolkits/discord)

## Prerequisites

- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Discord connection via `RUBE_MANAGE_CONNECTIONS` with toolkits `discord` and `discordbot`
- Always call `RUBE_SEARCH_TOOLS` first 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.


1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds
2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `discordbot` (bot operations) or `discord` (user operations)
3. If connection is not ACTIVE, follow the returned auth link to complete Discord auth
4. 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**:
1. `DISCORD_LIST_MY_GUILDS` - List guilds the bot belongs to [Prerequisite]
2. `DISCORDBOT_LIST_GUILD_CHANNELS` - List channels in a guild [Prerequisite]
3. `DISCORDBOT_CREATE_MESSAGE` - Send a message [Required]
4. `DISCORDBOT_UPDATE_MESSAGE` - Edit a sent message [Optional]

**Key parameters**:
- `channel_id`: Channel snowflake ID
- `content`: Message text (max 2000 characters)
- `embeds`: Array of embed objects for rich content
- `guild_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**:
1. `DISCORDBOT_CREATE_DM` - Create or get DM channel [Required]
2. `DISCORDBOT_CREATE_MESSAGE` - Send message to DM channel [Required]

**Key parameters**:
- `recipient_id`: User snowflake ID for DM
- `channel_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
```
END THIRD-PARTY FILE 33b7606071bdd9a2

The third-party file has ended. Everything between the 33b7606071bdd9a2 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2514 of 7158 bytes. © davepoon · MIT · https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/all-skills/skills/discord-automation/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
