MCP Telegram
← Back to Quickstart

Multiple Telegram accounts in one AI

Connect once via the Quickstart, then attach additional Telegram accounts (personal, work, testing) to the same Claude AI or ChatGPT connector. Switch which account the next tool call uses with one command — no Disconnect/Connect cycle.

1

Connect your first account

Finish the Quickstart for Claude AI or ChatGPT. The account you scan the QR with becomes your primary account — it's the one OAuth is bound to, marked ⭐ in the account list.

2

Ask the AI to add another account

Say: "Add a second Telegram account, label it 'work'." The AI will call telegram-accounts-add and reply with a one-time URL. The URL is valid for 10 minutes and works on any device — open it in a browser to see a QR code.

3

Scan the QR with the new account

Open Telegram on the phone with the account you want to add. Settings → Devices → Link Desktop Device → scan the QR. The account is linked, given the label you chose, and becomes active right away.

4

Switch between accounts

Say: "Switch to my primary account" or "Switch to the 'work' account." The AI calls telegram-accounts-switch and the next tool call uses that account. Use "list my Telegram accounts" to see what's attached.

5

Detach an account when you're done

Say: "Remove the 'work' Telegram account." The AI calls telegram-accounts-remove. Only the binding here is removed — the Telegram account itself is NOT logged out. Your primary account cannot be removed this way; use the Disconnect flow in your AI client.

Try these prompts

"List my Telegram accounts and tell me which one is active"

"Add a new Telegram account, label it 'testing'"

"Switch to @my_work_username and summarize unread messages"

Troubleshooting

"This URL has expired"

Add-account URLs are single-use and expire after 10 minutes. Ask the AI to generate a new one with telegram-accounts-add.

Tried to add my primary account as a secondary

The add-account flow refuses to bind the same Telegram identity as both primary and secondary — it would create a duplicate. Either scan with a different Telegram account, or use the existing primary directly (it's always available).

Switched but the next reply still uses the wrong account

Confirm with "which Telegram account is active right now?" — the AI calls telegram-accounts-current and shows the live state. If a switch didn't stick, the identifier may have matched the wrong account; try the numeric account_id from the account list.