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 MCP, CLI, and Lua Integration for AI Agents

Telegram integration docs for AI agents: MCP gateway setup, Telegram CLI commands, Lua API reference, credentials, and function schemas.

7 functions 5 read 2 write Bearer token auth

Submit Telegram feedback View package source

Telegram for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: telegram
route_slug: telegram
package: telegram
auth_strategy: bearer_token Bearer token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. Telegram CLIHeadless setup and direct function calls. Telegram MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Telegram MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Telegram.

Telegram CLI Matrix

Use these pages for direct Telegram CLI workflows in scripts, CI, cron, and agent wrappers.

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

Function Catalog

Function	Type	Parameters	Description
`telegram.telegram_send_message`	Write `write`	5	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 `read`	3	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 `read`	0	Get information about the authenticated Telegram bot. Returns the bot ID, username, display name, and capability flags.
`telegram.telegram_list_chats`	Read `read`	1	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 `read`	1	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 `write`	6	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 `read`	0	Get the profile of the currently authenticated Telegram bot. Returns bot ID, username, display name, and capability flags.