Skip to contentBale Bot MCP Server — Install for Claude, Cursor & VS Code | MCPpediaBBale Bot MCP Server
Private, local Bale bot for agents: read, search and answer messages, ask and wait, files.
55FairInstall
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"sepehr071-bale-mcp": {
"command": "uvx",
"args": [
"bale-mcp"
],
"env": {
"BALE_BOT_TOKEN": "YOUR_BALE_BOT_TOKEN",
"BALE_ALLOWED_CHATS": "",
"BALE_MCP_DB": "",
"BALE_MCP_SEND_DIRS": "",
"BALE_MCP_PROXY": ""
}
}
}
}
Related servers
FMCP server for Firecrawl — web search, scraping, and biomedical/arXiv paper search.
Environment
| Name | Required | Notes |
|---|
| BALE_BOT_TOKEN | Yes | Bot token from @botfather in Bale (https://ble.ir/botfather). Secret. |
| BALE_ALLOWED_CHATS | No | Comma-separated chat ids or @usernames the bot may read and message; all other chats are ignored. Recommended. |
| BALE_MCP_DB | No | Local message history file (default ~/.bale-mcp/messages.db); ':memory:' keeps nothing on disk. |
| BALE_MCP_SEND_DIRS | No | Folders bot_send_file may upload local files from (os.pathsep-separated); default is the download folder and the working directory. |
| BALE_MCP_PROXY | No | Optional HTTP proxy URL for every request; system proxy settings are ignored. |
Tools show up when the registry metadata or the repository README lists them. GitHub enrichment fills this in when a token is configured.
About
Private, local Bale bot for agents: read, search and answer messages, ask and wait, files.
FAQ
- What is Bale Bot?
- Private, local Bale bot for agents: read, search and answer messages, ask and wait, files.
- How do I install Bale Bot?
- Pick a client above and copy the generated config. Cursor and VS Code also have a deep link when the server can run locally or remotely.
- Is Bale Bot official?
- No. Registry-listed is not the same as vendor-official. Read the methodology for the difference.
- How is the trust score calculated?
- This listing scores 55 (Fair). The formula is published on the methodology page.
Reviews
0 published · no average
Sign in to review this server.
Good
Search, read, annotate, and add to your Zotero research library, local or web.
HLocal-first agentic RAG with citations - hybrid search, reranking, multimodal document retrieval
MLocal-first, cloud-friendly memory — 100+ tools, 99.2% LongMemEval-S retrieval@8, hybrid search.
DCrawl documentation sites into local corpora agents can search, read, and diff fully offline.
OSecure MCP access to Onyx search, chat, projects, and administration.