MCP server
Bale Bot
Private, local Bale bot for agents: read, search and answer messages, ask and wait, files.
Runs locallyStatus and history
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.3.1
- Listing updated
- 5 days ago
About Bale Bot
Bale Bot is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add bale-mcp --env BALE_BOT_TOKEN='<BALE_BOT_TOKEN>' -- uvx bale-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"bale-mcp": {
"command": "uvx",
"args": [
"bale-mcp"
],
"env": {
"BALE_BOT_TOKEN": "<BALE_BOT_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"bale-mcp": {
"command": "uvx",
"args": [
"bale-mcp"
],
"env": {
"BALE_BOT_TOKEN": "<BALE_BOT_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"bale-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"bale-mcp"
],
"env": {
"BALE_BOT_TOKEN": "<BALE_BOT_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"bale-mcp": {
"command": "uvx",
"args": [
"bale-mcp"
],
"env": {
"BALE_BOT_TOKEN": "<BALE_BOT_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"bale-mcp": {
"command": "uvx",
"args": [
"bale-mcp"
],
"env": {
"BALE_BOT_TOKEN": "<BALE_BOT_TOKEN>"
}
}
}
}Configuration
BALE_BOT_TOKENBot token from @botfather in Bale (https://ble.ir/botfather).RequiredBALE_ALLOWED_CHATSComma-separated chat ids or @usernames the bot may read and message; all other chats are ignored. Recommended.BALE_MCP_DBLocal message history file (default ~/.bale-mcp/messages.db); ':memory:' keeps nothing on disk.BALE_MCP_SEND_DIRSFolders bot_send_file may upload local files from (os.pathsep-separated); default is the download folder and the working directory.BALE_MCP_PROXYOptional HTTP proxy URL for every request; system proxy settings are ignored.
Pricing
Open source
Bale Bot FAQ
Is Bale Bot free?
Yes. Bale Bot is open source, so you can use and self-host it for free.
How do I add Bale Bot to Claude Code?
Run this command in your terminal: claude mcp add bale-mcp --env BALE_BOT_TOKEN='<BALE_BOT_TOKEN>' -- uvx bale-mcp