MCP server for Bale (بله) messenger bots in Iran: let AI agents read, search and answer messages, ask and wait for replies, and send files. Runs locally with your bot token.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add bale-bot --env BALE_BOT_TOKEN='<BALE_BOT_TOKEN>' -- uvx bale-mcp~/.codex/config.toml
[mcp_servers.bale-bot]
command = "uvx"
args = ["bale-mcp"]
env = { BALE_BOT_TOKEN = "<BALE_BOT_TOKEN>" }
# codex mcp add bale-bot --env BALE_BOT_TOKEN='<BALE_BOT_TOKEN>' -- uvx bale-mcp~/.cursor/mcp.json
{
"mcpServers": {
"bale-bot": {
"command": "uvx",
"args": [
"bale-mcp"
],
"env": {
"BALE_BOT_TOKEN": "<BALE_BOT_TOKEN>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"bale-bot": {
"type": "stdio",
"command": "uvx",
"args": [
"bale-mcp"
],
"env": {
"BALE_BOT_TOKEN": "<BALE_BOT_TOKEN>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"bale-bot": {
"command": "uvx",
"args": [
"bale-mcp"
],
"env": {
"BALE_BOT_TOKEN": "<BALE_BOT_TOKEN>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"bale-bot": {
"command": "uvx",
"args": [
"bale-mcp"
],
"env": {
"BALE_BOT_TOKEN": "<BALE_BOT_TOKEN>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"bale-bot": {
"command": "uvx",
"args": [
"bale-mcp"
],
"env": {
"BALE_BOT_TOKEN": "<BALE_BOT_TOKEN>"
}
}
}
}Environment variables
BALE_BOT_TOKEN
Replace the placeholders with your own credentials and keep them out of version control.