Tailscale MCP Server
Manage a Tailscale tailnet from an agent: devices, ACLs, DNS, keys and audit logs
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"tailscale-mcp": {
"command": "npx",
"args": [
"-y",
"@yawlabs/tailscale-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tailscale-mcp": {
"command": "npx",
"args": [
"-y",
"@yawlabs/tailscale-mcp"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools