Discordbot CLI for AI Agents

CLIs are eating MCPs. The industry is converging on the very same idea. MCPs for all their merit can be token hungry, slow, and unreliable for complex tool chaining. However, coding agents have become incredibly good at working with CLIs, and in fact they are far more comfortable working with CLI tools than MCP. With Composio's Universal CLI, your coding agents can talk to over 1000+ SaaS applications. With Discordbot, agents can add reaction emoji to welcome message, bulk delete spam messages in general channel, assign moderator role to user instantly, and more — all without worrying about authentication. This guide walks you through Composio Universal CLI and explains how you can connect it with coding agents like Claude Code, Codex, OpenCode, etc, for end-to-end Discordbot automation.

Get started for freeGet a demo
Discordbot logoDiscordbot
Oauth2

Discordbot is an automation tool for Discord servers that handles moderation, messaging, and user engagement. It helps communities run smoothly by automating routine and complex tasks.

165 Tools

Introduction

CLIs are eating MCPs. The industry is converging on the very same idea. MCPs for all their merit can be token hungry, slow, and unreliable for complex tool chaining. However, coding agents have become incredibly good at working with CLIs, and in fact they are far more comfortable working with CLI tools than MCP.

With Composio's Universal CLI, your coding agents can talk to over 1000+ SaaS applications. With Discordbot, agents can add reaction emoji to welcome message, bulk delete spam messages in general channel, assign moderator role to user instantly, and more — all without worrying about authentication.

This guide walks you through Composio Universal CLI and explains how you can connect it with coding agents like Claude Code, Codex, OpenCode, etc, for end-to-end Discordbot automation.

Also integrate Discordbot with

OpenAI Agents SDKClaude Agent SDKClaude CodeClaude CoworkCodexOpenClawHermesGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAI

What is Universal CLI and why use it?

The idea behind building the universal CLI is to give agents a single command interface to interact with all your external applications. Here's what you'll get with it:

  • Agent-friendly: Coding agents like Claude Code, Codex, and OpenCode can use CLI tools natively — no MCP setup required.
  • Authentication handled: Connect once via OAuth or API Key, and all CLI commands work with your credentials automatically.
  • Tool discovery: Search, inspect, and execute 20,000+ tools across 1000+ apps from one interface.
  • Trigger support: Use triggers to listen for events across your apps, powered by real-time webhooks or polling under the hood.
  • Type generation: Generate typed schemas for autocomplete and type safety in your projects.

Prerequisites

Install the Composio CLI, authenticate, and initialize your project:

bash
# Install the Composio CLI
curl -fsSL https://composio.dev/install | bash

# Authenticate with Composio
composio login

During login you'll be redirected to sign in page, finish the complete flow and you're all set.

Composio CLI authentication flow

Connecting Discordbot to Coding Agents via Universal CLI

Once it is installed, it's essentially done. Claude Code, Codex, OpenCode, OpenClaw, or any other agent will be able to access the CLI. A few steps to give agents access to your apps.

  1. Launch your Coding Agent — Claude Code, Codex, OpenCode, anything you prefer.
  2. Prompt it to "Authenticate with Discordbot"
  3. Complete the authentication and authorization flow and your Discordbot integration is all set.
  4. Start asking anything you want.

Universal CLI Commands for Discordbot

You can also manually execute CLI commands to interact with your Discordbot.

Connect your Discordbot account

Link your Discordbot account and verify the connection:

bash
# Connect your Discordbot account (opens OAuth flow)
composio connected-accounts link discordbot

# Verify the connection
composio connected-accounts list --toolkits discordbot

Discover Discordbot tools

Search and inspect available Discordbot tools:

bash
# List all available Discordbot tools
composio tools list --toolkit discordbot

# Search for Discordbot tools by action
composio tools search "discordbot"

# Inspect a tool's input schema
composio tools info DISCORDBOT_ADD_GROUP_DM_USER

Common Discordbot Actions

Add recipient to group channel — Adds a user to a discord group direct message (dm) channel

bash
composio tools execute DISCORDBOT_ADD_GROUP_DM_USER \
  --user_id "200000000000000000" \
  --channel_id "100000000000000000"

Update guild member information — Adds a user (who is not already a member) to a guild using their `access token` (which must have `guilds

bash
composio tools execute DISCORDBOT_ADD_GUILD_MEMBER \
  --user_id "769872908053901322" \
  --guild_id "81384788765712384" \
  --access_token "<string>"

Assign role to guild member — Assigns a role to a guild member, provided the bot has 'manage roles' permission in the guild and the role to be assigned is hierarchically lower than the bot's highest role

bash
composio tools execute DISCORDBOT_ADD_GUILD_MEMBER_ROLE \
  --role_id "865648175033647105" \
  --user_id "262626262626262626" \
  --guild_id "865648175033647104"

Add reaction to message — Adds an emoji reaction from the authenticated user/bot to a specific message in a discord channel; does not return information about existing reactions

bash
composio tools execute DISCORDBOT_ADD_MY_MESSAGE_REACTION \
  --channel_id "<string>" \
  --emoji_name "<string>" \
  --message_id "<string>"

Generate Type Definitions

Generate typed schemas for Discordbot tools to get autocomplete and type safety in your project:

bash
# Auto-detect language
composio generate --toolkits discordbot

# TypeScript
composio ts generate --toolkits discordbot

# Python
composio py generate --toolkits discordbot

Tips & Tricks

  • Always inspect a tool's input schema before executing: composio tools info <TOOL_NAME>
  • Pipe output with jq for better readability: composio tools execute TOOL_NAME -d '{}' | jq
  • Set COMPOSIO_API_KEY as an environment variable for CI/CD pipelines
  • Use composio dev logs tools to inspect execution logs and debug issues

Next Steps

  • Try asking your coding agent to perform various Discordbot operations
  • Explore cross-app workflows by connecting more toolkits
  • Set up triggers for real-time automation
  • Use composio generate for typed schemas in your projects
TOOLS

Supported Tools

Every Discordbot action and event your agent gets out of the box.

Add recipient to group channel

Adds a user to a Discord group DM channel.

Add guild member

Adds a user to a Discord guild using their OAuth2 access token (which must have guilds.

Assign role to guild member

Assigns a role to a guild member.

Add Reaction To Message

Adds an emoji reaction from the bot to a message.

Add thread member

Adds a user to a specific, unarchived thread.

Ban user from guild

Permanently bans a user from a Discord guild, optionally deleting their recent messages.

Bulk ban users from guild

Bans up to 200 users from a Discord guild, optionally deleting their recent messages.

Bulk Delete Messages

Bulk deletes messages in a Discord channel.

Create global application command

Creates a new global Discord application command.

Create auto moderation rule

Creates a new auto moderation rule for a Discord guild.

Create channel invite

Creates a new invite link for a Discord channel.

Initiate user channel with recipient

Creates a new direct message (DM) channel or retrieves an existing one, using recipient_id for a 1-on-1 DM or access_tokens for a group DM; this action only establishes or fetches the channel and does not send messages.

Create new guild

Creates a new Discord guild (server).

Create guild application command

Creates a new guild-specific application command.

Create guild channel

Creates a new Discord channel (text, voice, category, etc.

Create guild emoji

Creates a new custom emoji in a specified Discord guild, requiring CREATE_EXPRESSIONS permission and adherence to guild emoji limits.

Create guild from template

Creates a new Discord guild by applying channels, roles, and settings from a specified guild template code.

Create role with guild id

Creates a new role in a Discord guild with customizable name, permissions, color, hoist, mentionability, and icon.

Create guild scheduled event

Creates a new scheduled event in a Discord guild.

Create guild sticker

Uploads a PNG, APNG, GIF, or Lottie JSON file (max 512KB) as a new custom sticker to the specified Discord guild; requires Manage Expressions permission.

Create guild template

Creates a template of an existing Discord guild's structure (settings, roles, channels) but not its content (messages, members).

Post interaction callback

Sends a response to a Discord interaction (e.

Send Message To Channel

Sends a message to a Discord channel.

Create stage instance

Creates a new Stage instance in a Stage channel for hosting live audio events.

Create new thread in channel

Creates a new thread in a text, announcement, forum, or media channel.

Create thread from message

Creates a new thread from a specific message in a Discord channel, requiring CREATE_PUBLIC_THREADS permission.

Create channel webhook

Creates a new webhook in a specified Discord channel, requiring MANAGE_WEBHOOKS permission.

Crosspost Message

Crossposts a message from an announcement channel to all channels following it.

Delete All Reactions

Removes all reactions from a message.

Delete All Reactions By Emoji

Removes all reactions for a specific emoji from a message.

Delete global application command

Permanently deletes a global application command.

Delete auto moderation rule

Permanently deletes a specific auto moderation rule from a Discord guild.

Delete channel by id

Permanently deletes a Discord channel by its ID.

Delete channel permission override

Removes channel-specific permission overwrites for a user or role, reverting them to default permissions inherited from the server or category.

Remove user from group DM

Removes a recipient from a Discord group DM channel.

Delete guild by id

Permanently deletes a specified Discord guild (server).

Delete guild application command

Permanently deletes a guild-specific application command.

Delete guild emoji by id

Permanently deletes a specified custom emoji from a guild, requiring Manage Expressions permissions; cannot delete default emojis and is irreversible.

Delete guild integration

Permanently deletes a specific integration from a Discord guild, removing any associated webhooks and kicking the bot if present.

Delete guild member by id

Removes (kicks) a member from a Discord guild.

Delete guild member role

Removes a specified role from a member of a Discord guild.

Delete role from guild

Permanently deletes a specified role from a Discord guild, revoking it from all members.

Delete guild scheduled event

Permanently deletes a specific scheduled event from a Discord guild.

Delete guild sticker

Permanently deletes a custom sticker from a Discord guild; the specified guild and sticker must exist, and this action is irreversible.

Delete guild template by code

Deletes an existing guild template by its unique code from a specified guild, returning the deleted template's details.

Delete Message

Permanently deletes a message from a Discord channel.

Remove My Reaction

Removes the bot's own emoji reaction from a message.

Delete original webhook message

Permanently deletes the original (@original) message posted by a webhook or interaction response.

Delete stage instance

Permanently deletes the Stage instance for a given stage channel, ending the live audio event.

Remove thread member

Removes a user from a specified, unarchived thread.

Remove User Reaction

Removes a specific user's emoji reaction from a message.

Delete webhook by id

Permanently deletes a Discord webhook by its unique ID.

Delete webhook by token

Permanently deletes a Discord webhook using its ID and token, without bot authentication.

Delete webhook message

Deletes a message previously sent by a Discord webhook.

Execute GitHub-compatible webhook

Forwards GitHub event notifications to a Discord channel via a GitHub-compatible webhook endpoint.

Execute Slack-compatible webhook

Sends messages to Discord via its Slack-compatible webhook endpoint, supporting Slack attachment formatting.

Execute webhook

Executes a Discord webhook to send messages, embeds, or interactive components to a channel or thread.

Add follower to channel via webhook

Follows an Announcement Channel to relay its messages to a target channel via webhook.

List active threads in guild

Retrieves all active (non-archived) threads in a Discord guild that the bot can access.

Get application details

Retrieves the full details of a Discord application by its application_id.

Get global application command

Retrieves a specific global application command by its application ID and command ID.

Get application role connections metadata

Retrieves all role connection metadata records for a Discord application.

Get user role connection

Fetches the role connection object for the current user for a specified Discord application.

Get auto moderation rule

Retrieves the complete configuration of a specific auto moderation rule within a Discord guild.

Get bot gateway

Retrieves the WSS URL, recommended shard count, and session start limits for connecting a bot to the Discord Gateway.

Retrieve channel details

Retrieves detailed metadata for a specific Discord channel by its channel_id.

Get gateway URL

Retrieves the WebSocket URL to connect to Discord's Gateway for receiving real-time events.

Retrieve guild details

Retrieves detailed information for a specified Discord guild (server) by its guild_id, optionally including approximate member and presence counts if with_counts is true.

Get guild application command

Retrieves detailed information for a specific application command within a Discord guild.

Get guild command permissions

Retrieves the permissions for a specific application command within a guild.

Get guild ban

Fetches the ban details for a specific user in a Discord guild, if that user is currently banned.

Fetch emoji by guild and id

Retrieves details for a specific custom emoji within a specified Discord guild, requiring valid and accessible guild and emoji IDs.

Retrieve guild member by user id

Retrieves detailed information for a specific member of a Discord guild, provided the bot belongs to the guild and has necessary permissions.

Preview guild by id

Fetches a public preview of a Discord guild by its ID, if the guild has the preview feature enabled.

Get guild scheduled event

Retrieves a specific scheduled event from a Discord guild by its ID, optionally including the count of subscribed users.

Get guild onboarding

Retrieves the onboarding settings for a specified Discord guild, including prompts, options, default channels, and enabled status.

Retrieve sticker from guild

Retrieves a specific sticker from a Discord guild using the guild and sticker IDs; requires the sticker to exist in the guild.

Retrieve guild template with code

Retrieves the complete structure and details of a Discord guild template using its unique code.

Retrieve guild vanity url

Retrieves the vanity URL invite code and usage count for a Discord guild.

Retrieve guild webhooks

Retrieves all webhooks for a specified Discord guild, requiring MANAGE_WEBHOOKS permission.

Retrieve guild welcome screen

Retrieves the welcome screen configuration for a Discord guild with the Community feature enabled.

Retrieve guild widget json

Retrieves the public JSON widget data for a Discord guild, if the widget is enabled for that guild.

Get Guild Widget PNG

Tool to retrieve a PNG image widget for a Discord guild.

Retrieve guild widget settings

Retrieves the widget settings for a specified Discord guild, indicating if the widget is enabled and its configured channel ID.

Get Message

Retrieves a specific message from a Discord channel by channel and message ID.

Get my application

Retrieves detailed information about the current authenticated Discord application via /applications/@me.

Get my OAuth2 application

Retrieves detailed information about the OAuth2 application associated with the current authentication.

Retrieve original webhook message

Retrieves the original (@original) message from a Discord webhook or interaction response.

Get OAuth2 public keys

Retrieves Discord's OAuth2 public keys in JWK format for verifying access tokens.

Get stage instance

Retrieves the active Stage instance for a specified stage channel.

Get sticker

Retrieves a specific Discord sticker by its unique ID.

Retrieve thread member by id

Retrieves a member from a specified thread using their user ID, optionally including guild member details.

Get user

Fetches public information for a Discord user by their user ID.

Retrieve webhook by id

Retrieves detailed information for a Discord webhook by its unique ID.

Retrieve webhook by token

Retrieves a Discord webhook's configuration using its ID and token, without requiring bot authentication.

Retrieve webhook message

Retrieves a specific message previously sent by a Discord webhook.

Resolve invite by code

Resolves a Discord invite code to get its details, optionally including member counts and expiration.

Revoke invite by code

Revokes a Discord invite using its code, permanently preventing new joins via this link.

Join thread

Joins the authenticated user to a thread specified by channel_id.

Leave Guild

Enables the bot to leave a specified Discord guild (server).

Leave thread

Removes the currently authenticated user from a specified thread.

List global application commands

Fetches all global application commands for the specified Discord application.

List auto moderation rules

Retrieves all auto moderation rules for a specified Discord guild.

List channel invites

Fetches all active invites for a given Discord channel.

List Channel Webhooks

Retrieves all webhooks configured in a given Discord channel.

List guild command permissions

Retrieves all guild-level permission settings for all commands of a specific application within a guild.

List guild application commands

Fetches all application commands registered for a specific guild.

Get guild audit logs

Retrieves audit log entries for a specified Discord guild, requiring VIEW_AUDIT_LOG permission.

List guild bans

Fetches a list of users banned from a specified Discord guild.

Retrieve guild channels

Fetches all channels (text, voice, category, etc.

Retrieve guild emojis

Fetches all custom emoji objects for a specified Discord guild if the bot has access; returns only custom guild emojis, not standard Unicode or Nitro emojis.

List guild integrations

Lists all integration objects for a specified Discord guild.

List guild invites

Retrieves all currently active invite codes for a specified Discord guild.

Get guild members

Retrieves a list of members for a Discord guild.

List guild roles

Fetches all roles in a Discord guild, providing details for each role including permissions, color, position, and other attributes.

List guild scheduled events

Retrieves a list of scheduled events for a specified Discord guild, optionally including subscribed user counts.

List scheduled event users

Fetches users who have expressed interest in a specific scheduled event within a Discord guild.

Retrieve guild stickers

Retrieves all custom sticker objects for a Discord guild; does not include standard/Nitro stickers.

Get guild templates by guild id

Retrieves all guild templates for an existing Discord guild, specified by its ID.

List guild voice regions

Fetches a list of available voice regions for a specified Discord guild.

List Reactions By Emoji

Lists users who reacted to a message with a specific emoji.

Fetch Messages From Channel

Retrieves messages from a Discord channel, ordered newest first.

List my private archived threads

Retrieves private archived threads from a channel that the current user is a member of.

List Pinned Messages

Retrieves all pinned messages from a Discord channel.

List private archived threads

Lists private archived threads in a Discord channel, sorted by most recent archival.

List public archived threads

Lists public archived threads in a Discord channel, sorted by most recent archival.

List sticker packs

Fetches all available Nitro sticker packs from Discord, excluding custom or guild-specific sticker packs.

List thread members

Retrieves members of a specified Discord thread, with an option to include full guild member objects.

List voice regions

Lists all available Discord voice regions that can be used when setting a voice or stage channel's region.

Pin Message

Pins a message in a Discord channel.

Preview guild prune

Previews the number of members that would be pruned from a Discord guild based on inactivity days and optional roles; does not remove members.

Prune inactive guild members

Removes inactive members from a Discord guild.

Update guild onboarding configuration

Configures or updates a Discord guild's new member onboarding flow, including prompts, options, default channels, and enabled status.

Search guild members by username or nickname

Searches for members in a specific Discord guild by matching a query string against usernames and nicknames.

Modify channel permissions

Updates or creates a permission overwrite for a role (type 0) or member (type 1) within a Discord channel using allow and deny bitwise values.

Sync guild template

Synchronizes a guild template with its source guild, updating it to match the source's current configuration; does not affect guilds already created from this template.

Test bot token authentication

Tool to validate the configured Discord bot token by fetching the current authenticated bot user.

Trigger typing indicator

Shows the bot is typing in a Discord channel.

Unban user from guild

Revokes a ban for a user from a Discord guild, allowing them to rejoin.

Unpin Message

Unpins a message from a Discord channel.

Update application

Updates a Discord application's settings using its application_id.

Update global application command

Updates properties of a global application command.

Update user application role connection

Updates the current user's application role connection metadata for Discord's Linked Roles feature.

Update auto moderation rule

Updates an existing auto moderation rule in a Discord guild.

Update channel settings

Updates a Discord channel's settings (name, topic, permissions, etc.

Update guild settings

Updates settings for a Discord guild (server).

Update guild application command

Updates properties of a guild-specific application command.

Update guild emoji

Updates a custom emoji's name and/or role restrictions in a Discord guild; cannot create or delete emojis, and role updates for managed emojis may be restricted by their integration.

Modify guild member details

Updates a guild member's attributes including nickname, roles, voice state, timeout status, and flags.

Modify guild role

Updates a Discord guild role's attributes (name, permissions, color, etc.

Update guild scheduled event

Updates an existing scheduled event in a Discord guild.

Update guild sticker info

Modifies a guild sticker's name, description, or tags.

Update guild template

Updates a Discord guild template's name and/or description; omitted fields retain current values, and an empty string for description clears it.

Update guild welcome screen

Updates a guild's welcome screen configuration, including description, enabled status, and up to 5 welcome channels.

Update guild widget settings

Updates a Discord guild's widget settings, such as its enabled state or invite channel.

Edit Message

Edits a message previously sent by the bot.

Update my application

Updates settings for the current authenticated Discord application via /applications/@me.

Update bot's nickname in guild

Modifies the current bot's member profile (nickname) in a Discord guild.

Update current bot user profile

Updates the current bot user's Discord username and/or avatar.

Update original webhook message

Updates the original (@original) message previously sent by a webhook or interaction response.

Update own voice state

Updates the bot's own voice state in a guild Stage channel, such as toggling suppress or requesting to speak.

Update user voice state

Updates another user's voice state in a Discord stage channel.

Update webhook details

Updates properties of an existing Discord webhook such as name, avatar, or channel.

Update webhook by token

Updates a Discord webhook's name and/or avatar using its ID and token, without bot authentication.

Update webhook message

Updates a message previously sent by a webhook, allowing modification of content, embeds, attachments, or components.

FRAMEWORKS

How to build Discordbot MCP Agent with another framework

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Discordbot MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Discordbot MCP with Claude Agent SDK

Claude Code logo

Claude Code

Use Discordbot MCP with Claude Code

Claude Cowork logo

Claude Cowork

Use Discordbot MCP with Claude Cowork

Codex logo

Codex

Use Discordbot MCP with Codex

OpenClaw logo

OpenClaw

Use Discordbot MCP with OpenClaw

Hermes logo

Hermes

Use Discordbot MCP with Hermes

Google ADK logo

Google ADK

Use Discordbot MCP with Google ADK

LangChain logo

LangChain

Use Discordbot MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Discordbot MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Discordbot MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Discordbot MCP with LlamaIndex

CrewAI logo

CrewAI

Use Discordbot MCP with CrewAI

FAQ

Frequently asked questions

The Composio Universal CLI is a single command-line interface that lets coding agents and developers interact with 1000+ SaaS applications. It handles authentication, tool discovery, action execution, and trigger setup — all from the terminal, without needing to configure MCP servers.

Any coding agent that can run shell commands works with the Composio CLI — including Claude Code, Codex, OpenCode, OpenClaw, and others. Once the CLI is installed, agents automatically discover and use the composio commands to interact with Discordbot and other connected apps.

MCP servers require configuration and can be token-heavy for complex workflows. The CLI gives agents a direct, lightweight interface — no server setup needed. Agents simply call composio commands like any other shell tool. It's faster to set up, more reliable for multi-step tool chaining, and works natively with how coding agents already operate.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Discordbot data and credentials are handled as safely as possible. You can also bring your own OAuth credentials for full control.

Start with Discordbot.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Discordbot tool your agent needs.Free to start.

Start building
Customer stories

Teams ship real agents on Composio

GET STARTED FOR FREEBOOK A DEMO
agent.aiZoomLettaGleanHubSpotAWSWabi

Karan skipped his own birthday party to fix our critical issue. It was 10pm and he diverted his Waymo to help us instead. This really sets the bar — it shows the commitment you need when users rely on your software.

Harsha Gaddipati
Harsha Gaddipati
Co-founder, Slashy

A lot of students tell us that the moment their connected tools start talking to each other inside Opennote feels almost magical. The agent just knows them, and it's immensely helped keep new users on the platform.

Abhi Arya
Abhi Arya
Co-founder, Opennote

We chose Composio over Pipedream because it delivered depth where it mattered — niche tools and tricky edge cases other platforms simply ignored. That gave us confidence to scale without compromising.

Nirman Dave
Nirman Dave
CEO, Zams

As a solo builder, shipping fast is life or death. The only way I can outcompete incumbents is by outmanoeuvring them. Getting bogged down managing agent auth would have been a death sentence.

Ryan Yu
Ryan Yu
Founder, Extra Thursday

Before Composio, adding tool integrations was slow and resource-intensive. Each one could take weeks of engineering time, and maintaining them meant constantly keeping up with API changes.

Tomisin Jenrola
Tomisin Jenrola
Founder & CEO, SwarmZero

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.

Jerome Leclanche
Jerome Leclanche
Co-Founder, Ingram Technologies