How do I install the mcp netbird mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `NETBIRD_API_TOKEN`, `NETBIRD_HOST` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

MCP Netbird MCP Server

A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for [Netbird](https://netbird.io/).

Local serverstdioGo

What is the MCP Netbird MCP Server?

MCP Netbird connects MCP Netbird to AI assistants that speak the Model Context Protocol. A Model Context Protocol (MCP) server for Netbird.

What MCP Netbird does

A Model Context Protocol (MCP) server for Netbird.

Key capabilities

Uses Netbird API to access configuration and status
Configurable API endpoint
Secure token-based authentication for Netbird API

Practical notes

Maintained by aantti, written in Go.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
list_netbird_peers	All peers
list_netbird_port_allocations	All ingress ports for peerId
list_netbird_groups	All groups
list_netbird_policies	All policies
list_netbird_posture_checks	All posture checks
list_netbird_networks	All networks
list_netbird_nameservers	All nameserver groups

How to install the MCP Netbird MCP Server

{
  "mcpServers": {
    "netbird": {
      "command": "mcp-netbird",
      "args": [],
      "env": {
        "NETBIRD_API_TOKEN": "YOUR_NETBIRD_API_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
NETBIRD_API_TOKEN	Declared in the maintainer’s client configuration.	Check documentation

Example prompts to try

“Use MCP Netbird to list netbird peers.”
“Use MCP Netbird to list netbird port allocations.”
“Use MCP Netbird to list netbird groups.”

Frequently asked questions

A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for [Netbird](https://netbird.io/). Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.