Back to Browse

Bale MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (2 strong, 2 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (4/4 approved).

10 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

database

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Bot token from @botfather in Bale (https://ble.ir/botfather).Required

Environment variable: BALE_BOT_TOKEN

Comma-separated chat ids or @usernames the bot may read and message; all other chats are ignored. Recommended.Optional

Environment variable: BALE_ALLOWED_CHATS

Local message history file (default ~/.bale-mcp/messages.db); ':memory:' keeps nothing on disk.Optional

Environment variable: BALE_MCP_DB

Optional HTTP proxy URL for every request; system proxy settings are ignored.Optional

Environment variable: BALE_MCP_PROXY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-sepehr071-bale-mcp": {
      "env": {
        "BALE_MCP_DB": "your-bale-mcp-db-here",
        "BALE_BOT_TOKEN": "your-bale-bot-token-here",
        "BALE_MCP_PROXY": "your-bale-mcp-proxy-here",
        "BALE_ALLOWED_CHATS": "your-bale-allowed-chats-here"
      },
      "args": [
        "bale-mcp"
      ],
      "command": "uvx"
    }
  }
}

Reviews

No reviews yet

Be the first to review this server!