Beszel

FreeNot checked

MCP server for Beszel system monitoring that provides tools to list systems, containers, alerts, and query CPU, memory, disk, and network stats.

by weeebdev

GitHub Embed

About

MCP server for Beszel system monitoring that provides tools to list systems, containers, alerts, and query CPU, memory, disk, and network stats.

README

A Model Context Protocol server for the Beszel system/container monitoring tool. Run it with npx — no git clone required.

Built on the same PocketBase API used by the Beszel Raycast extension and inspired by Red5d/beszel-mcp.

Tools

Tool	Description
`list_systems`	List monitored systems with status and metadata
`list_containers`	List monitored containers
`list_alerts`	List configured alerts
`list_alert_history`	List triggered alert history
`query_system_stats`	Query CPU, memory, disk, and network stats for a system
`query_container_stats`	Query CPU, memory, and network stats for a container

All list tools support PocketBase filter, sort, and pagination.

Configuration

Set these environment variables:

Variable	Required	Description
`BESZEL_URL`	Yes	Beszel/PocketBase URL (e.g. `http://localhost:8090`)
`BESZEL_EMAIL`	No	Admin email for authentication
`BESZEL_PASSWORD`	No	Admin password for authentication

Installation

No git clone required. The server runs from the published npm package:

npx -y beszel-mcp

Usage

Cursor / Claude Desktop

Add to your MCP config. Use the npm package name beszel-mcp — not a local path:

{
  "mcpServers": {
    "beszel": {
      "command": "npx",
      "args": ["-y", "beszel-mcp"],
      "env": {
        "BESZEL_URL": "http://localhost:8090",
        "BESZEL_EMAIL": "[email protected]",
        "BESZEL_PASSWORD": "your-password"
      }
    }
  }
}

Contributing / local development

npm install
npm run build
npm start

Or run without building:

npm install
npm run dev

MCP Inspector

npm run inspect

PocketBase filter examples

name ~ 'server'
status = 'up'
created >= '2024-01-01' && created <= '2024-12-31'
(cpu > 80 || memory > 90) && status = 'active'

License

MIT

from github.com/weeebdev/beszel-mcp

Install Beszel in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install beszel-mcp

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add beszel-mcp -- npx -y beszel-mcp

FAQ

Is Beszel MCP free?

Yes, Beszel MCP is free — one-click install via Unyly at no cost.

Does Beszel need an API key?

No, Beszel runs without API keys or environment variables.

Is Beszel hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install Beszel in Claude Desktop, Claude Code or Cursor?

Open Beszel on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

GitHub

PRs, issues, code search, CI status

by GitHub

Filesystem

Secure file operations with configurable access controls.

by Community

Memory

Knowledge graph-based persistent memory system.

by Community

Template MCP Server

A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure

by mcpdotdirect

Compare Beszel with

BeszelvsGitHub BeszelvsFilesystem BeszelvsMemory BeszelvsTemplate MCP Server

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs