Discord

Send messages, read history, and manage channels in Discord with DiscordTools.

DiscordTools enable an agent to send messages, read message history, manage channels, and delete messages in Discord.

Prerequisites

The following example requires the requests and openai libraries and a Discord bot token which can be obtained from here.

uv pip install -U requests openai

export DISCORD_BOT_TOKEN=***

Example

cookbook/91_tools/discord_tools.py

from agno.agent import Agent
from agno.tools.discord import DiscordTools

agent = Agent(
    tools=[DiscordTools()],
    markdown=True,
)

agent.print_response("Send 'Hello World!' to channel 1234567890", markdown=True)

Toolkit Params

Parameter	Type	Default	Description
bot_token	Optional[str]	None	Discord bot token for authentication. Falls back to the DISCORD_BOT_TOKEN environment variable.
enable_send_message	bool	True	Whether to enable sending messages to channels.
enable_get_channel_messages	bool	True	Whether to enable retrieving message history from channels.
enable_get_channel_info	bool	True	Whether to enable fetching channel info.
enable_list_channels	bool	True	Whether to enable listing channels in a server.
enable_delete_message	bool	True	Whether to enable deleting messages from channels.
all	bool	False	Enable all functions.

Toolkit Functions

Function	Description
send_message	Send a message to a specified channel. Returns a success or error message.
get_channel_info	Retrieve information about a specified channel. Returns the channel info as a JSON string.
list_channels	List all channels in a specified server (guild). Returns the list of channels as JSON.
get_channel_messages	Retrieve message history from a specified channel. Returns messages as a JSON string.
delete_message	Delete a specific message by ID from a specified channel. Returns a success or error message.

Developer Resources

• Tools