Telbot
Go-based tool for managing Telkomsel accounts via Telegram Bot, Terminal CLI, or MCP Server (for AI agents).
What is Telbot?
Telbot is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to go-based tool for managing telkomsel accounts via telegram bot, terminal cli, or mcp server (for ai agents).
Go-based tool for managing Telkomsel accounts via Telegram Bot, Terminal CLI, or MCP Server (for AI agents).
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Go-based tool for managing Telkomsel accounts via Telegram B
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx telbotConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Telbot
Telbot is a Go-based multi-interface tool for managing Telkomsel mobile accounts — Indonesia's largest telecom — through a Telegram Bot, a terminal CLI, or an MCP Server interface designed for AI agent integration. It handles SMS OTP-based login with session caching, profile and balance queries, quota status checks, package purchasing via Pulsa or QRIS, and an auto-buy monitor that triggers purchases when data quota drops below a configurable threshold. The MCP server mode makes Telbot accessible to AI assistants like Claude, enabling automated telecom account management through natural language commands.
Prerequisites
- Go 1.21 or later installed (for building from source), or a pre-built binary from the Releases page
- A Telkomsel account with an active SIM card for SMS OTP login
- A Telegram Bot token from BotFather (TELKOMSEL_BOT_TOKEN) if using the bot mode
- Your Telegram user ID (TELEGRAM_ADMIN_ID) for the bot admin configuration
- An MCP client such as Claude Desktop if using MCP server mode
Download or build the Telbot binary
Download a pre-built binary from the GitHub Releases page for your platform (Windows, Linux, macOS), or build from source with Go.
# Build from source
git clone https://github.com/0xtbug/telbot
cd telbot
go mod tidy
go build -o telbot .Create the configuration file
Create the config file at the platform-specific location and add your credentials. On Linux/macOS: ~/.config/telbot/.env. On Windows: %APPDATA%\telbot\.env.
mkdir -p ~/.config/telbot
cat > ~/.config/telbot/.env << 'EOF'
TELKOMSEL_BOT_TOKEN=your_telegram_bot_token
TELEGRAM_ADMIN_ID=your_telegram_user_id
OTP_WEBHOOK_PORT=8080
OTP_WEBHOOK_SECRET=your_webhook_secret
EOFTest Telegram Bot mode
Start Telbot in Telegram Bot mode to verify your credentials and Telkomsel login flow work correctly before enabling MCP mode.
./telbot --botStart in MCP server mode
Run Telbot with the --mcp flag to start the Model Context Protocol server interface for AI agent integration.
./telbot --mcpConfigure your MCP client
Add the Telbot MCP server to your Claude Desktop configuration. The binary must be accessible at the specified path.
{
"mcpServers": {
"telbot": {
"command": "/path/to/telbot",
"args": ["--mcp"],
"env": {
"TELKOMSEL_BOT_TOKEN": "your_telegram_bot_token",
"TELEGRAM_ADMIN_ID": "your_telegram_user_id"
}
}
}
}Telbot Examples
Client configuration
Add this block to your claude_desktop_config.json to run Telbot in MCP server mode, enabling Claude to manage your Telkomsel account.
{
"mcpServers": {
"telbot": {
"command": "/path/to/telbot",
"args": ["--mcp"],
"env": {
"TELKOMSEL_BOT_TOKEN": "your_telegram_bot_token",
"TELEGRAM_ADMIN_ID": "your_telegram_user_id"
}
}
}
}Prompts to try
Once connected via MCP, use these prompts to manage your Telkomsel account through Claude.
- "Check my current Telkomsel data quota and balance"
- "Show me available data packages for my Telkomsel number"
- "What is my Telkomsel profile and account status?"
- "Set up auto-buy to purchase a data package when my quota drops below 500MB"
- "Log in to my Telkomsel account using OTP"Troubleshooting Telbot
OTP login fails or times out
Ensure your Telkomsel SIM card is active and can receive SMS. The OTP webhook (OTP_WEBHOOK_PORT) must be reachable if you are using automated OTP forwarding. For manual flows, enter the OTP within the time limit shown.
Binary not found or permission denied when Claude starts the server
Verify the full path to the telbot binary in your MCP config is correct, and that the binary is executable: chmod +x /path/to/telbot.
Config file not found error on startup
Create the config directory and .env file at ~/.config/telbot/.env (Linux/macOS) or %APPDATA%\telbot\.env (Windows). At minimum set TELKOMSEL_BOT_TOKEN and TELEGRAM_ADMIN_ID.
Frequently Asked Questions about Telbot
What is Telbot?
Telbot is a Model Context Protocol (MCP) server that go-based tool for managing telkomsel accounts via telegram bot, terminal cli, or mcp server (for ai agents). It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Telbot?
Follow the installation instructions on the Telbot GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Telbot?
Telbot works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Telbot free to use?
Yes, Telbot is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Telbot Alternatives — Similar Communication Servers
Looking for alternatives to Telbot? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Telbot in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Telbot?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.