Skip to main content
The Discord plugin connects Lukan to your Discord server using discord.js with Gateway WebSocket.

​
Setup

​
1. Create a Discord App

  1. Go to discord.com/developers/applications and create a new application
  2. In Bot, reset the token and copy it
  3. Enable Message Content Intent in Privileged Gateway Intents
  4. In OAuth2 > URL Generator, select scope bot with permissions Send Messages and Read Message History
  5. Open the generated URL to invite the bot to your server

​
2. Configure in Lukan

lukan plugin install discord
lukan dc config set botToken "YOUR_BOT_TOKEN"
lukan plugin start discord

​
Configuration

FieldDescription
botTokenDiscord bot token
allowedChannelsChannel IDs where the bot responds (empty = everywhere)
allowedUsersUser IDs allowed to interact (empty = all)
prefixCommand prefix filter
replyInThreadCreate/reply in threads (default: true)
enableVoiceEnable voice channel transcription
transcriptionBackendlocal (whisper.cpp) or openai

​
Voice Notes

When enableVoice is enabled, the bot can join voice channels and transcribe meetings:
  • !notes start — start recording in the current voice channel
  • !notes stop — stop recording and generate a summary with action items

​
Pipeline Approvals

Discord works as a notification channel for approval gates. You can use:
  • Channel ID — sends to the channel
  • User ID — sends a DM to the user
To find IDs: enable Developer Mode in Discord settings (Advanced), then right-click any channel or user and select Copy ID.