$ cat ~/map/pi-discord.md

pi-discord

Read-only Discord integration for pi: list servers, channels, and messages, optionally send with confirmation.

extensions✓ Oct 16

## TL;DR

Read-only Discord integration for pi that talks to the bot REST API — no gateway, no daemon — exposing tools to list guilds, channels, messages, and members, plus an optional send that prompts for confirmation.

## Key points

• $Read-only by default (plus optional send) via the Discord bot REST API — no gateway connection and no daemon process.
• $Tools: discord_get_guilds (list servers), discord_get_channels (list channels in a guild), discord_get_messages (1-100 recent messages, default 25), discord_get_members (1-1000 members, default 100), and discord_send_message, which prompts for confirmation before posting.
• $Setup: create a bot in the Discord developer portal, enable Message Content Intent, invite it with View Channels, Read Message History, and Send Messages permissions, then run /discord-setup in pi and paste the token — config is saved to ~/.pi/agent/extensions/pi-discord.json. A DISCORD_BOT_TOKEN environment variable works as an alternative.
• $Commands: /discord shows the connection status and /discord-setup configures the bot token interactively.
• $Install by adding the package path to the packages array in ~/.pi/agent/settings.json, then run /reload in pi.

## FAQ

## References

• README (setup, tools, commands) ↗

Last updated: Aug 31, 2026