mcpbeat Sign in

Balmas MCP Server

local only

Balmas MCP runs on your own machine — the client starts it, so there is no endpoint to ping. 82 installs a week from npm. Last commit 3 Sep 2026.

Agents read cleaned copies of your files: PII replaced with local consistent tokens. Read-only.

Installs per day peak 35 · avg 10 · +2% w/w
a month agotoday
82
Installs / week
npm · balmas-mcp
0
Stars
0 open issues
3 Sep 2026
Last commit
5 releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 2 d ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Reads files and sends them to the network src/index.ts:241
      for (const name of fs.readdirSync(dir)) {

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add balmas-mcp -e 'BALMAS_API_KEY=<BALMAS_API_KEY>' -- npx -y balmas-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "balmas-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "balmas-mcp"
      ],
      "env": {
        "BALMAS_API_KEY": "<BALMAS_API_KEY>"
      }
    }
  }
}
~/.codex/config.toml
[mcp_servers.balmas-mcp]
command = "npx"
args = ["-y", "balmas-mcp"]
env = { BALMAS_API_KEY = "<BALMAS_API_KEY>" }
.cursor/mcp.json
{
  "mcpServers": {
    "balmas-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "balmas-mcp"
      ],
      "env": {
        "BALMAS_API_KEY": "<BALMAS_API_KEY>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "balmas-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "balmas-mcp"
      ],
      "env": {
        "BALMAS_API_KEY": "<BALMAS_API_KEY>"
      }
    }
  }
}

Put your own value in place of <BALMAS_API_KEY> (BALMAS API key (bk_...) - free at balmasai.com/app/team). The author’s registry entry marks it as required.

Alternatives to Balmas MCP

same job, measured the same way
Markdown Pipeline
by markdown-pipeline

Your team's Jira as clean Markdown files, kept current for your AI agent. Local and read-only.

2 128 installs/wk local only
DataCharter
by datacharter

Local-first, contract-governed data explorer with read-only, PII-masked query tools for AI agents.

634 installs/wk local only
Commonly
by team-commonly

Read Commonly pods and post as a Commonly agent you create, with a token from your Commonly account.

4 908 installs/wk local only
Llmxray
by lognebudo

What went wrong with your own Ollama calls, in sentences with the fix. Local, read-only.

415 installs/wk local only
Tare
by priberry-data

See where your coding agent's tokens and money went, with cache-safe fixes. Local.

544 installs/wk local only
Onion Search
by farbodghasemlu

Local, read-only onion search and text retrieval over Tor with content filtering.

local only
H
Hidden Tokens
by ai4xedu

Anonymize client files on your computer before Claude reads them; real values restored locally.

local only
Carbon Forge
by 100monkeys-ai

One record of code, files and pages that people and agents read and write, with lanes and git.

22 tools answering

Balmas MCP — questions

Answers built from our own checks of this server.

Why is there no uptime for Balmas MCP?
Balmas MCP runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package balmas-mcp was installed 82 times last week.
How do I connect Balmas MCP?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls balmas-mcp straight from npm; nothing to host, nothing to sign up for.
How many people use Balmas MCP?
The npm package balmas-mcp was installed 82 times in the last week. Week over week that is +2%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Balmas MCP open source?
Yes — it is published under the MIT licence, written in TypeScript and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.