# Tailscale MCP Server

> Tailscale MCP Server is an open-source MCP server for cloud and infrastructure. Manage a Tailscale tailnet from an agent: devices, ACLs, DNS, keys and audit logs. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://yaw.sh/mcp-servers/tailscale-mcp/
- **Repository:** https://github.com/yawlabs/tailscale-mcp
- **MCP Registry name:** io.github.YawLabs/tailscale-mcp
- **Categories:** cloud and infrastructure, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/tailscale-mcp-server-2
