Discordbot CLI for AI Agents

Trusted by
AWS
Glean
Zoom
Airtable
GET STARTED FOR FREEGET A DEMO

30 min · no commitment · see it on your stack

Discordbot logo
CLI logo
divider

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

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.

Supported Tools & Triggers

Tools
Add recipient to group channelAdds a user to a Discord group DM channel.
Add guild memberAdds a user to a Discord guild using their OAuth2 access token (which must have guilds.
Assign role to guild memberAssigns a role to a guild member.
Add Reaction To MessageAdds an emoji reaction from the bot to a message.
Add thread memberAdds a user to a specific, unarchived thread.
Ban user from guildPermanently bans a user from a Discord guild, optionally deleting their recent messages.
Bulk ban users from guildBans up to 200 users from a Discord guild, optionally deleting their recent messages.
Bulk Delete MessagesBulk deletes messages in a Discord channel.
Create global application commandCreates a new global Discord application command.
Create auto moderation ruleCreates a new auto moderation rule for a Discord guild.
Create channel inviteCreates a new invite link for a Discord channel.
Initiate user channel with recipientCreates 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 guildCreates a new Discord guild (server).
Create guild application commandCreates a new guild-specific application command.
Create guild channelCreates a new Discord channel (text, voice, category, etc.
Create guild emojiCreates a new custom emoji in a specified Discord guild, requiring CREATE_EXPRESSIONS permission and adherence to guild emoji limits.
Create guild from templateCreates a new Discord guild by applying channels, roles, and settings from a specified guild template code.
Create role with guild idCreates a new role in a Discord guild with customizable name, permissions, color, hoist, mentionability, and icon.
Create guild scheduled eventCreates a new scheduled event in a Discord guild.
Create guild stickerUploads 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 templateCreates a template of an existing Discord guild's structure (settings, roles, channels) but not its content (messages, members).
Post interaction callbackSends a response to a Discord interaction (e.
Send Message To ChannelSends a message to a Discord channel.
Create stage instanceCreates a new Stage instance in a Stage channel for hosting live audio events.
Create new thread in channelCreates a new thread in a text, announcement, forum, or media channel.
Create thread from messageCreates a new thread from a specific message in a Discord channel, requiring CREATE_PUBLIC_THREADS permission.
Create channel webhookCreates a new webhook in a specified Discord channel, requiring MANAGE_WEBHOOKS permission.
Crosspost MessageCrossposts a message from an announcement channel to all channels following it.
Delete All ReactionsRemoves all reactions from a message.
Delete All Reactions By EmojiRemoves all reactions for a specific emoji from a message.
Delete global application commandPermanently deletes a global application command.
Delete auto moderation rulePermanently deletes a specific auto moderation rule from a Discord guild.
Delete channel by idPermanently deletes a Discord channel by its ID.
Delete channel permission overrideRemoves channel-specific permission overwrites for a user or role, reverting them to default permissions inherited from the server or category.
Remove user from group DMRemoves a recipient from a Discord group DM channel.
Delete guild by idPermanently deletes a specified Discord guild (server).
Delete guild application commandPermanently deletes a guild-specific application command.
Delete guild emoji by idPermanently deletes a specified custom emoji from a guild, requiring Manage Expressions permissions; cannot delete default emojis and is irreversible.
Delete guild integrationPermanently deletes a specific integration from a Discord guild, removing any associated webhooks and kicking the bot if present.
Delete guild member by idRemoves (kicks) a member from a Discord guild.
Delete guild member roleRemoves a specified role from a member of a Discord guild.
Delete role from guildPermanently deletes a specified role from a Discord guild, revoking it from all members.
Delete guild scheduled eventPermanently deletes a specific scheduled event from a Discord guild.
Delete guild stickerPermanently deletes a custom sticker from a Discord guild; the specified guild and sticker must exist, and this action is irreversible.
Delete guild template by codeDeletes an existing guild template by its unique code from a specified guild, returning the deleted template's details.
Delete MessagePermanently deletes a message from a Discord channel.
Remove My ReactionRemoves the bot's own emoji reaction from a message.
Delete original webhook messagePermanently deletes the original (@original) message posted by a webhook or interaction response.
Delete stage instancePermanently deletes the Stage instance for a given stage channel, ending the live audio event.
Remove thread memberRemoves a user from a specified, unarchived thread.
Remove User ReactionRemoves a specific user's emoji reaction from a message.
Delete webhook by idPermanently deletes a Discord webhook by its unique ID.
Delete webhook by tokenPermanently deletes a Discord webhook using its ID and token, without bot authentication.
Delete webhook messageDeletes a message previously sent by a Discord webhook.
Execute GitHub-compatible webhookForwards GitHub event notifications to a Discord channel via a GitHub-compatible webhook endpoint.
Execute Slack-compatible webhookSends messages to Discord via its Slack-compatible webhook endpoint, supporting Slack attachment formatting.
Execute webhookExecutes a Discord webhook to send messages, embeds, or interactive components to a channel or thread.
Add follower to channel via webhookFollows an Announcement Channel to relay its messages to a target channel via webhook.
List active threads in guildRetrieves all active (non-archived) threads in a Discord guild that the bot can access.
Get application detailsRetrieves the full details of a Discord application by its application_id.
Get global application commandRetrieves a specific global application command by its application ID and command ID.
Get application role connections metadataRetrieves all role connection metadata records for a Discord application.
Get user role connectionFetches the role connection object for the current user for a specified Discord application.
Get auto moderation ruleRetrieves the complete configuration of a specific auto moderation rule within a Discord guild.
Get bot gatewayRetrieves the WSS URL, recommended shard count, and session start limits for connecting a bot to the Discord Gateway.
Retrieve channel detailsRetrieves detailed metadata for a specific Discord channel by its channel_id.
Get gateway URLRetrieves the WebSocket URL to connect to Discord's Gateway for receiving real-time events.
Retrieve guild detailsRetrieves 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 commandRetrieves detailed information for a specific application command within a Discord guild.
Get guild command permissionsRetrieves the permissions for a specific application command within a guild.
Get guild banFetches the ban details for a specific user in a Discord guild, if that user is currently banned.
Fetch emoji by guild and idRetrieves details for a specific custom emoji within a specified Discord guild, requiring valid and accessible guild and emoji IDs.
Retrieve guild member by user idRetrieves detailed information for a specific member of a Discord guild, provided the bot belongs to the guild and has necessary permissions.
Preview guild by idFetches a public preview of a Discord guild by its ID, if the guild has the preview feature enabled.
Get guild scheduled eventRetrieves a specific scheduled event from a Discord guild by its ID, optionally including the count of subscribed users.
Get guild onboardingRetrieves the onboarding settings for a specified Discord guild, including prompts, options, default channels, and enabled status.
Retrieve sticker from guildRetrieves 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 codeRetrieves the complete structure and details of a Discord guild template using its unique code.
Retrieve guild vanity urlRetrieves the vanity URL invite code and usage count for a Discord guild.
Retrieve guild webhooksRetrieves all webhooks for a specified Discord guild, requiring MANAGE_WEBHOOKS permission.
Retrieve guild welcome screenRetrieves the welcome screen configuration for a Discord guild with the Community feature enabled.
Retrieve guild widget jsonRetrieves the public JSON widget data for a Discord guild, if the widget is enabled for that guild.
Get Guild Widget PNGTool to retrieve a PNG image widget for a Discord guild.
Retrieve guild widget settingsRetrieves the widget settings for a specified Discord guild, indicating if the widget is enabled and its configured channel ID.
Get MessageRetrieves a specific message from a Discord channel by channel and message ID.
Get my applicationRetrieves detailed information about the current authenticated Discord application via /applications/@me.
Get my OAuth2 applicationRetrieves detailed information about the OAuth2 application associated with the current authentication.
Retrieve original webhook messageRetrieves the original (@original) message from a Discord webhook or interaction response.
Get OAuth2 public keysRetrieves Discord's OAuth2 public keys in JWK format for verifying access tokens.
Get stage instanceRetrieves the active Stage instance for a specified stage channel.
Get stickerRetrieves a specific Discord sticker by its unique ID.
Retrieve thread member by idRetrieves a member from a specified thread using their user ID, optionally including guild member details.
Get userFetches public information for a Discord user by their user ID.
Retrieve webhook by idRetrieves detailed information for a Discord webhook by its unique ID.
Retrieve webhook by tokenRetrieves a Discord webhook's configuration using its ID and token, without requiring bot authentication.
Retrieve webhook messageRetrieves a specific message previously sent by a Discord webhook.
Resolve invite by codeResolves a Discord invite code to get its details, optionally including member counts and expiration.
Revoke invite by codeRevokes a Discord invite using its code, permanently preventing new joins via this link.
Join threadJoins the authenticated user to a thread specified by channel_id.
Leave GuildEnables the bot to leave a specified Discord guild (server).
Leave threadRemoves the currently authenticated user from a specified thread.
List global application commandsFetches all global application commands for the specified Discord application.
List auto moderation rulesRetrieves all auto moderation rules for a specified Discord guild.
List channel invitesFetches all active invites for a given Discord channel.
List Channel WebhooksRetrieves all webhooks configured in a given Discord channel.
List guild command permissionsRetrieves all guild-level permission settings for all commands of a specific application within a guild.
List guild application commandsFetches all application commands registered for a specific guild.
Get guild audit logsRetrieves audit log entries for a specified Discord guild, requiring VIEW_AUDIT_LOG permission.
List guild bansFetches a list of users banned from a specified Discord guild.
Retrieve guild channelsFetches all channels (text, voice, category, etc.
Retrieve guild emojisFetches 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 integrationsLists all integration objects for a specified Discord guild.
List guild invitesRetrieves all currently active invite codes for a specified Discord guild.
Get guild membersRetrieves a list of members for a Discord guild.
List guild rolesFetches all roles in a Discord guild, providing details for each role including permissions, color, position, and other attributes.
List guild scheduled eventsRetrieves a list of scheduled events for a specified Discord guild, optionally including subscribed user counts.
List scheduled event usersFetches users who have expressed interest in a specific scheduled event within a Discord guild.
Retrieve guild stickersRetrieves all custom sticker objects for a Discord guild; does not include standard/Nitro stickers.
Get guild templates by guild idRetrieves all guild templates for an existing Discord guild, specified by its ID.
List guild voice regionsFetches a list of available voice regions for a specified Discord guild.
List Reactions By EmojiLists users who reacted to a message with a specific emoji.
Fetch Messages From ChannelRetrieves messages from a Discord channel, ordered newest first.
List my private archived threadsRetrieves private archived threads from a channel that the current user is a member of.
List Pinned MessagesRetrieves all pinned messages from a Discord channel.
List private archived threadsLists private archived threads in a Discord channel, sorted by most recent archival.
List public archived threadsLists public archived threads in a Discord channel, sorted by most recent archival.
List sticker packsFetches all available Nitro sticker packs from Discord, excluding custom or guild-specific sticker packs.
List thread membersRetrieves members of a specified Discord thread, with an option to include full guild member objects.
List voice regionsLists all available Discord voice regions that can be used when setting a voice or stage channel's region.
Pin MessagePins a message in a Discord channel.
Preview guild prunePreviews 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 membersRemoves inactive members from a Discord guild.
Update guild onboarding configurationConfigures or updates a Discord guild's new member onboarding flow, including prompts, options, default channels, and enabled status.
Search guild members by username or nicknameSearches for members in a specific Discord guild by matching a query string against usernames and nicknames.
Modify channel permissionsUpdates 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 templateSynchronizes 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 authenticationTool to validate the configured Discord bot token by fetching the current authenticated bot user.
Trigger typing indicatorShows the bot is typing in a Discord channel.
Unban user from guildRevokes a ban for a user from a Discord guild, allowing them to rejoin.
Unpin MessageUnpins a message from a Discord channel.
Update applicationUpdates a Discord application's settings using its application_id.
Update global application commandUpdates properties of a global application command.
Update user application role connectionUpdates the current user's application role connection metadata for Discord's Linked Roles feature.
Update auto moderation ruleUpdates an existing auto moderation rule in a Discord guild.
Update channel settingsUpdates a Discord channel's settings (name, topic, permissions, etc.
Update guild settingsUpdates settings for a Discord guild (server).
Update guild application commandUpdates properties of a guild-specific application command.
Update guild emojiUpdates 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 detailsUpdates a guild member's attributes including nickname, roles, voice state, timeout status, and flags.
Modify guild roleUpdates a Discord guild role's attributes (name, permissions, color, etc.
Update guild scheduled eventUpdates an existing scheduled event in a Discord guild.
Update guild sticker infoModifies a guild sticker's name, description, or tags.
Update guild templateUpdates 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 screenUpdates a guild's welcome screen configuration, including description, enabled status, and up to 5 welcome channels.
Update guild widget settingsUpdates a Discord guild's widget settings, such as its enabled state or invite channel.
Edit MessageEdits a message previously sent by the bot.
Update my applicationUpdates settings for the current authenticated Discord application via /applications/@me.
Update bot's nickname in guildModifies the current bot's member profile (nickname) in a Discord guild.
Update current bot user profileUpdates the current bot user's Discord username and/or avatar.
Update original webhook messageUpdates the original (@original) message previously sent by a webhook or interaction response.
Update own voice stateUpdates the bot's own voice state in a guild Stage channel, such as toggling suppress or requesting to speak.
Update user voice stateUpdates another user's voice state in a Discord stage channel.
Update webhook detailsUpdates properties of an existing Discord webhook such as name, avatar, or channel.
Update webhook by tokenUpdates a Discord webhook's name and/or avatar using its ID and token, without bot authentication.
Update webhook messageUpdates a message previously sent by a webhook, allowing modification of content, embeds, attachments, or components.

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

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

What is the Composio Universal CLI?

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.

Which coding agents work with the Composio CLI?

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.

How is the CLI different from using an MCP server for Discordbot?

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.

How safe is my Discordbot data when using the Composio CLI?

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.

Used by agents from

Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Get started for freeGet a demo↗