Telegram
The Telegram integration lets you send notes to Coeus from your phone. You set up a Telegram bot, link it to Coeus, and then send messages to the bot: they show up as notes.
Why this exists
Coeus is a desktop app. When you're not at your computer and you want to capture something quickly, you need another way in. I use Telegram because it's always on my phone and I was already using it.
Setup
Step 1: Create a Telegram bot
- Open Telegram and search for @BotFather
- Send
/newbot - Follow the prompts: give your bot a name and a username
- BotFather gives you a bot token. Copy it.
Step 2: Add the token to Coeus
- Open Settings → Integrations → Telegram Bridge
- Toggle it on
- Paste your bot token
- Click Save
Step 3: Link your Telegram account
- Click Generate link code in the settings
- A short code appears (e.g.
ABCD1234) - Open Telegram, find your bot, and send it:
/link ABCD1234 - The bot replies confirming it's linked
Now you're connected.
What you can send
Text messages: Any message you send the bot becomes a note.
Voice messages: Send a voice note. Coeus transcribes it and saves the transcript as a note.
Photos: Send a photo. It gets imported as an attachment.
Documents: Send a file (PDF, image, etc.). It gets imported as an attachment and indexed.
URLs: Send a link. Coeus imports the page as a note, same as pasting a URL in the desktop app.
Asking questions
You can also ask questions through Telegram. Send a message like "What did I write about last week's meeting?" and the bot searches your notes and replies.
The bot uses the AI provider you have configured in Coeus. It only works with the Anthropic API, OpenAI-compatible API, or Coeus Cloud: not with agent runtimes like Claude Code.
Bot commands
| Command | What it does |
|---|---|
/help | Shows available commands |
/status | Shows whether the bot is connected and which AI provider is active |
/forget | Clears the bot's conversation memory (not your notes) |
/link CODE | Links a new Telegram account |
Privacy
The bot only responds to the account you linked it to. Anyone else who messages your bot gets no response. The bot token is stored in your operating system's keychain.
Your conversation with the bot stays in memory (up to a few hundred messages) so it has context for follow-up questions. The /forget command clears this memory.
Unlinking
To unlink your Telegram account: Settings → Integrations → Telegram → Unlink. You can re-link with a new code at any time.