Bale Bot MCP Server

Private, local Bale bot for agents: read, search and answer messages, ask and wait, files.

Local serverstdio

What is the Bale Bot MCP Server?

Bale Bot is an MCP integration. Private, local Bale bot for agents: read, search and answer messages, ask and wait, files.

Packages and local setup

The published pypi package is bale-mcp, version 0.1.2. Its declared MCP transport is stdio.

The package declares BALE_BOT_TOKEN (required): Bot token from @botfather in Bale (https://ble.ir/botfather).; BALE_ALLOWED_CHATS: Comma-separated chat ids or @usernames the bot may read and message; all other chats are ignored. Recommended.; BALE_MCP_DB: Local message history file (default ~/.bale-mcp/messages.db); ':memory:' keeps nothing on disk.; BALE_MCP_PROXY: Optional HTTP proxy URL for every request; system proxy settings are ignored..

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository · Project website. This profile uses version 0.1.2 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related other integrations MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
BALE_BOT_TOKENBot token from @botfather in Bale (https://ble.ir/botfather).Yes
BALE_ALLOWED_CHATSComma-separated chat ids or @usernames the bot may read and message; all other chats are ignored. Recommended.Check documentation
BALE_MCP_DBLocal message history file (default ~/.bale-mcp/messages.db); ':memory:' keeps nothing on disk.Check documentation
BALE_MCP_PROXYOptional HTTP proxy URL for every request; system proxy settings are ignored.Check documentation