BalenaMCP
A simple MCP server that wraps the balena CLI to provide Balena capabilities
to supported clients.
Prerequisites
- Go 1.21 or later
balenaCLI installed and available in PATH- Claude Desktop installed
Power your agent
Install from the publisher. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
No packaged release in the registry yet. Follow the repository README.
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchFrom the publisher
A simple MCP server that wraps the balena CLI to provide Balena capabilities
to supported clients.
balena CLI installed and available in PATHA simple MCP server that wraps the `balena` CLI to provide Balena capabilities to supported clients.
# Clone the repository
git clone https://github.com/klutchell/balenamcp.git
cd balenamcp
# Install dependencies
go mod download
# Build the binary
go build -o bin/balenamcp
Open Claude Desktop
Go to the Claude menu and select "Settings..."
Click on "Developer" in the left-hand bar
You may need to enable Developer Mode to see this option.
Click on "Edit Config"
This will create or open a configuration file at:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonAdd the following configuration to the file:
{
"mcpServers": {
"balenamcp": {
"command": "/full/path/to/your/balenamcp/bin/balenamcp",
"args": []
}
}
}
Make sure to replace /full/path/to/your/balenamcp with the absolute path to
your project directory.
Save the file and restart Claude Desktop
Before using the tools, make sure you're authenticated with Balena:
balena login
The following commands are available through BalenaMCP:
device-list: List all devicesdevice-logs: Show device logs (requires device UUID or name)fleet-list: List all fleetsos-versions: Show available balenaOS versions for a device type (requires
device type)release-list: List all releases of a fleet (requires fleet name)release-info: Get info for a release (requires release ID)version: Display version information for the balena CLItag-list: List all tags for a fleet, device or release (requires resource
type and name)Each command can be accessed directly through Claude Desktop.
The server is built using the MCP Go library and communicates with Claude Desktop through standard input/output streams.
main.go: Main server implementation with tool definitionsserver/setup.go: Server setup and tool implementationsmain_test.go: Tests for the server implementationbin/: Built binaries (gitignored)# Build for current platform
go build -o bin/balenamcp
# Build for specific platforms
GOOS=linux GOARCH=amd64 go build -o bin/balenamcp-linux-amd64
GOOS=windows GOARCH=amd64 go build -o bin/balenamcp-windows-amd64.exe
GOOS=darwin GOARCH=amd64 go build -o bin/balenamcp-darwin-amd64
GOOS=darwin GOARCH=arm64 go build -o bin/balenamcp-darwin-arm64
go test ./...
If you encounter issues with the MCP server:
Check the logs in:
~/Library/Logs/Claude/mcp-server-balenamcp.log%APPDATA%\Claude\logs\mcp-server-balenamcp.logMake sure the path to the balenamcp binary is correct and absolute
Ensure you have the necessary permissions to execute the binary
Verify that balena is installed and accessible in your PATH
MIT
A simple MCP server that wraps the `balena` CLI to provide Balena capabilities to supported clients.
Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
No required environment variable is listed on this record.
Balenamcp runs locally over stdio.
Last checked 2026-10-28. A simple MCP server that wraps the `balena` CLI to provide Balena capabilities to supported clients.