NestDaddy
All servers NestDaddy MCP Blog Sign inTry it free
Search and web

Bale Bot

io.github.sepehr071/bale-mcp · v0.3.0

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

Website Source code Set it up

Connect Runs on your machine

Terminal
claude mcp add bale-mcp -e BALE_BOT_TOKEN=<BALE_BOT_TOKEN> -e BALE_ALLOWED_CHATS=<BALE_ALLOWED_CHATS> -e BALE_MCP_DB=<BALE_MCP_DB> -e BALE_MCP_SEND_DIRS=<BALE_MCP_SEND_DIRS> -e BALE_MCP_PROXY=<BALE_MCP_PROXY> -- uvx bale-mcp==0.3.0
claude_desktop_config.json
{
  "mcpServers": {
    "bale-mcp": {
      "command": "uvx",
      "args": [
        "bale-mcp==0.3.0"
      ],
      "env": {
        "BALE_BOT_TOKEN": "<BALE_BOT_TOKEN>",
        "BALE_ALLOWED_CHATS": "<BALE_ALLOWED_CHATS>",
        "BALE_MCP_DB": "<BALE_MCP_DB>",
        "BALE_MCP_SEND_DIRS": "<BALE_MCP_SEND_DIRS>",
        "BALE_MCP_PROXY": "<BALE_MCP_PROXY>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "bale-mcp": {
      "command": "uvx",
      "args": [
        "bale-mcp==0.3.0"
      ],
      "env": {
        "BALE_BOT_TOKEN": "<BALE_BOT_TOKEN>",
        "BALE_ALLOWED_CHATS": "<BALE_ALLOWED_CHATS>",
        "BALE_MCP_DB": "<BALE_MCP_DB>",
        "BALE_MCP_SEND_DIRS": "<BALE_MCP_SEND_DIRS>",
        "BALE_MCP_PROXY": "<BALE_MCP_PROXY>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "bale-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "bale-mcp==0.3.0"
      ],
      "env": {
        "BALE_BOT_TOKEN": "<BALE_BOT_TOKEN>",
        "BALE_ALLOWED_CHATS": "<BALE_ALLOWED_CHATS>",
        "BALE_MCP_DB": "<BALE_MCP_DB>",
        "BALE_MCP_SEND_DIRS": "<BALE_MCP_SEND_DIRS>",
        "BALE_MCP_PROXY": "<BALE_MCP_PROXY>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
BALE_BOT_TOKEN
Required, secret		Bot token from @botfather in Bale (https://ble.ir/botfather).
BALE_ALLOWED_CHATS
Optional		Comma-separated chat ids or @usernames the bot may read and message; all other chats are ignored. Recommended.
BALE_MCP_DB
Optional		Local message history file (default ~/.bale-mcp/messages.db); ':memory:' keeps nothing on disk.
BALE_MCP_SEND_DIRS
Optional		Folders bot_send_file may upload local files from (os.pathsep-separated); default is the download folder and the working directory.
BALE_MCP_PROXY
Optional		Optional HTTP proxy URL for every request; system proxy settings are ignored.

Details

Package[email protected] (PYPI, stdio)
First published6 Nov 2026
Last updated6 Nov 2026
Registry nameio.github.sepehr071/bale-mcp

More search and web servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.