Can I use Telegram as a CLI?

Yes. KosmoKrator exposes a Telegram CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Telegram through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Telegram tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Telegram credentials stored?

Telegram credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Telegram MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

communication

Telegram CLI for Headless Automation

Use the Telegram CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

7 functions 5 read 2 write Bearer token auth

Submit Telegram feedback View package source

Telegram CLI for Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. The Telegram CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Telegram CLI for Headless Automation
kosmokrator integrations:configure telegram --set access_token="$TELEGRAM_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call telegram.telegram_send_message '{"chat_id":"example_chat_id","text":"example_text","parse_mode":"example_parse_mode","reply_to_message_id":1,"disable_notification":true}' --json

Discovery Before Execution

Agents and scripts can inspect Telegram docs and schemas before choosing a function.

kosmo integrations:docs telegram --json
kosmo integrations:docs telegram.telegram_send_message --json
kosmo integrations:schema telegram.telegram_send_message --json
kosmo integrations:search "Telegram" --json
kosmo integrations:list --json

Useful Telegram CLI Functions

Function	Type	Parameters	Description
`telegram.telegram_send_message`	Write	chat_id, text, parse_mode, reply_to_message_id, disable_notification	Send a text message to a Telegram chat. Provide the chat_id and message text. The chat_id can be a numeric ID or @channelusername. Supports optional parse_mode (Markdown, MarkdownV2, HTML) and other formatting options.
`telegram.telegram_list_updates`	Read	offset, limit, timeout	Get incoming updates (messages, callback queries, inline queries, etc.) for the Telegram bot. Use offset to acknowledge previously received updates. Returns an array of update objects.
`telegram.telegram_get_me`	Read	none	Get information about the authenticated Telegram bot. Returns the bot ID, username, display name, and capability flags.
`telegram.telegram_list_chats`	Read	limit	List recent chats the bot has interacted with. Since Telegram Bot API does not have a native list-chats endpoint, this fetches recent updates and extracts unique chats. Returns chat IDs, types, and titles.
`telegram.telegram_get_chat`	Read	chat_id	Get information about a specific Telegram chat by its ID or @username. Returns chat type, title, description, member count, and other metadata.
`telegram.telegram_send_photo`	Write	chat_id, photo, caption, parse_mode, reply_to_message_id, disable_notification	Send a photo to a Telegram chat. Provide the chat_id and a photo URL or file_id. Supports optional caption with formatting and other options.
`telegram.telegram_get_current_user`	Read	none	Get the profile of the currently authenticated Telegram bot. Returns bot ID, username, display name, and capability flags.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related Telegram CLI Pages

CI Telegram CLI for CI. Cron Jobs Telegram CLI for cron jobs. Shell Scripts Telegram CLI for shell scripts. Coding Agents Telegram CLI for coding agents.