Skip to content
MCP server

Tailscale MCP Server

Manage a Tailscale tailnet from an agent: devices, ACLs, DNS, keys and audit logs

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.23.4
Listing updated
2 days ago

About Tailscale MCP Server

Tailscale MCP Server is an open-source MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.

The server wraps the Tailscale v2 admin API in 97 typed tools, plus six optional read-only diagnostics from the local tailscale binary, one always-on catalog tool and four resources. The README backs it with over 1,900 unit tests and an opt-in live-tailnet suite. Tools are grouped (status, devices, acl, dns, keys, users, tailnet, webhooks, posture, audit, invites, services, log-streaming, local-cli) so you can load only some of them.

ACL handling is the highlight. tailscale_get_acl returns the HuJSON policy with comments preserved and an ETag, and tailscale_update_acl requires that ETag, so concurrent edits conflict instead of overwriting each other. tailscale_diff_acl_access reports who gains and loses access from a proposed policy. Every write tool carries destructive or idempotent hints so clients can gate changes.

It runs locally through npx with an API key from the Tailscale admin console, which the README advises putting in the shell profile rather than a world-readable client config. It is MIT licensed, from Yaw Labs, and the authors say it suits exploratory admin work while plain curl is better for a single endpoint in CI.

Install

Run in a terminal

claude mcp add tailscale-mcp -- npx -y @yawlabs/tailscale-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "tailscale-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/tailscale-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tailscale-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/tailscale-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "tailscale-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/tailscale-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "tailscale-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/tailscale-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "tailscale-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/tailscale-mcp"
      ]
    }
  }
}

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

tailscale_get_acl
Return the ACL policy with HuJSON comments and an ETag
tailscale_update_acl
Update the ACL, requiring the ETag
tailscale_diff_acl_access
Show who gains and loses access under a proposed policy
tailscale_create_key
Create an auth key or OAuth client credential

What it does

Broad admin coverage
97 tools across devices, ACLs, DNS, keys, users, webhooks and more.
ETag-guarded ACL edits
Updates require the current ETag so concurrent changes conflict.
ACL access diff
Shows who gains or loses access from a proposed policy.
Audit and flow logs
Reads configuration audit and network flow logs.
Selective tool groups
Load only the groups you need.
Mutation hints
Writes are tagged destructive or idempotent for client gating.

Good for

  • Find devices not seen for 30 days with key expiry disabled
  • Investigate who changed DNS settings overnight
  • Draft and validate an ACL change that preserves comments
  • Rotate auth keys older than 90 days

Pricing

Open source

Free, MIT licensed; the Yaw Terminal app has a separate license that does not affect this server.

Prices change. Check yaw.sh before you buy.

Tailscale MCP Server FAQ

How do I authenticate?

Create an API key in the Tailscale admin console under Settings > Keys and set it as an environment variable.

Is it free?

Yes, MIT licensed and published on npm.

Should I use it instead of curl?

The README says curl suits a single endpoint in CI, while the MCP server suits interactive multi-step work.

Does it cover the local CLI?

Six optional read-only diagnostics use the local tailscale binary.

Is Tailscale MCP Server free?

Yes. Tailscale MCP Server is open source, so you can use and self-host it for free.

How do I add Tailscale MCP Server to Claude Code?

Run this command in your terminal: claude mcp add tailscale-mcp -- npx -y @yawlabs/tailscale-mcp

What are the best alternatives to Tailscale MCP Server?

The closest alternatives to Tailscale MCP Server are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Tailscale MCP Server

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools