Install Telegram MCP

Pick your client, copy the command, done.

Add it to Claude Code

claude mcp add -e "API_ID=${API_ID}" -e "API_HASH=${API_HASH}" -e "TELEGRAM_STORAGE_PATH=${TELEGRAM_STORAGE_PATH}" telegram-mcp-fcab -- /path/to/telegram-mcp

Required:API_IDAPI_HASHTELEGRAM_STORAGE_PATH

Environment Variables

Set these before running Telegram MCP.

VariableDescriptionRequired

API_IDTelegram API ID from my.telegram.orgYes

API_HASHTelegram API Hash from my.telegram.orgYes

TELEGRAM_STORAGE_PATHAbsolute path to the authenticated session storageYes

Available Tools (7)

Once configured, Telegram MCP gives your AI agent access to:

messages_sendTextSend a text message to a chat

chatIdtextreplyToMessageId

messages_getHistoryGet message history from a chat

chatIdlimitoffsetId

messages_searchSearch for messages

querychatIdlimit

messages_getRecentGet recent messages from all chats

limitmessagesPerChat

wait_for_replyWait for the next message in a chat

chatIdtimeoutSeconds

dialogs_listList all dialogs

limitfilter

dialogs_getInfoGet detailed dialog information

chatId

Try It Out

After setup, try these prompts with your AI agent:

→List my recent dialogs and tell me which groups have new messages.

→Search for the last message from 'John Doe' about the project meeting.

→Send a message to the 'Work' group saying that I will be 10 minutes late.

→Get the last 20 messages from my conversation with the 'Support' bot.

Conare · memory for coding agents

Keep this setup from going cold

Save the docs, env vars, and workflow around Telegram MCP in Conare so Claude Code, Codex, and Cursor remember it next time.

Remember this setup$npx conare@latest

← Telegram MCP overview Browse communication servers →