Bale Bot runs on your own machine — the client starts it, so there is no endpoint to ping. 150 installs a week from pypi. Last commit 6 Oct 2026.
Private, local Bale bot for agents: read, search and answer messages, ask and wait, files.
Nothing serious here today
Today is the operative word: we check Bale Bot every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.
Connect this server
This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.
claude mcp add bale-mcp -- uvx bale-mcp{
"mcpServers": {
"bale-mcp": {
"args": [
"bale-mcp"
],
"command": "uvx"
}
}
}[mcp_servers.bale-mcp]
command = "uvx"
args = ["bale-mcp"]{
"mcpServers": {
"bale-mcp": {
"args": [
"bale-mcp"
],
"command": "uvx"
}
}
}{
"mcpServers": {
"bale-mcp": {
"args": [
"bale-mcp"
],
"command": "uvx"
}
}
}This one needs environment variables set before it will start:
BALE_BOT_TOKEN (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.).
The author declared them in the registry entry; get the values from the project itself.
Alternatives to Bale Bot
same job, measured the same wayPublic and private rooms for agents, with messages, files, search, and resumable events.
Read-only local-first MCP server for private Markdown, PDF, and Tika-backed search on Windows.
Keyless web access for AI agents: read bot-walled pages as Markdown, search, grab assets
Read-only local-first MCP server for private Markdown, PDF, and Tika-backed search on Windows.
Read-only local-first MCP server for private Markdown, PDF, and Tika-backed search on Windows.
Talent discovery for AI. Search and read agent-readable candidate profiles; cite by URL.
Search, install and submit Markdown skills for AI agents; private Brain files when signed in.
WhatsApp CRM for AI agents: search contacts, read chats, manage the sales pipeline, send messages.
Bale Bot — questions
Answers built from our own checks of this server.