Allows sending notifications and requesting interactive confirmations via Telegram inline keyboard buttons, enabling users to approve or reject actions directly from their Telegram chat.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Kiro Telegram MCP Server Send notification that backup finished successfully."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A Python MCP (Model Context Protocol) server that integrates Kiro IDE with Telegram. Exposes three tools:
enviar_notificacion — Send notification messages to a Telegram chat.
solicitar_confirmacion — Request interactive confirmations via inline keyboard buttons.
solicitar_input_texto — Ask a question and receive a free-text reply from Telegram.
Python 3.10 or higher
A Telegram bot token (from @BotFather)
A Telegram chat ID
Related MCP server: Telegram Notify MCP Server
Clone the repository:
git clone https://github.com/jcsepulveda/mcp-kiro-telegram.git
cd mcp-kiro-telegramInstall dependencies:
python -m pip install -r requirements.txtCopy the environment example and fill in your credentials:
cp .env.example .envEdit .env with your Telegram bot token and chat ID.
Add the following to your ~/.kiro/settings/mcp.json:
{
"mcpServers": {
"kiro-telegram": {
"command": "python3",
"args": ["/path/to/mcp-kiro-telegram/server.py"],
"cwd": "/path/to/mcp-kiro-telegram"
}
}
}The cwd field is required so the server finds the .env file at startup.
Run the server via stdio (used by Kiro IDE):
python server.pyThe server communicates over stdin/stdout using the MCP JSON-RPC protocol.
enviar_notificacionSends a plain text message to the configured Telegram chat.
Parameter | Type | Required | Description |
| string | Yes | Message text (1-4096 characters) |
Returns success or error message.
solicitar_confirmacionSends a message with inline keyboard buttons and blocks until the user presses one.
Parameter | Type | Required | Description |
| string | Yes | Prompt message to display |
| list[str] | Yes | Button labels (1-10 items) |
| int | No | Seconds to wait (10-600, default 300) |
Returns the selected button's callback data, or error on timeout.
solicitar_input_textoSends a question and blocks until the user replies with a free-text message.
Parameter | Type | Required | Description |
| string | Yes | Question or prompt (1-4096 characters) |
| int | No | Seconds to wait (10-600, default 300) |
Returns the user's text reply, or error on timeout.
Variable | Description |
| Bot authentication token from BotFather |
| Numeric ID of the target Telegram chat |
For Kiro to automatically use Telegram for notifications and confirmations across all projects, place a steering file at ~/.kiro/steering/telegram-confirm.md. See the example in .kiro/steering/telegram-confirm.md within this repository.
The recommended steering implements:
Post-task notification: summary sent after every completed task.
Detail prompt: asks via buttons if the user wants the full response.
Pre-action confirmation: blocks before destructive operations.
Free-text input: uses solicitar_input_texto for open questions instead of waiting in terminal.
Python: 3.10+
Platforms: Windows, macOS, Linux
This server cannot be deployed
Project memory, tasks and Telegram notifications for your coding agent. Chip account required.
Telegram bridge for your MCP-compatible agent. Bidirectional, no LLM in our stack.
Run a Telegram channel from your AI agent. Posts go out through your own bot, not your account.
Manage Telegram drafts, media, schedules and publications from AI clients.
