Tailscale MCP Server

Name: Tailscale MCP Server
Author: HexSleeves

HexSleeves

server that provides seamless integration with Tailscale's CLI commands and REST API, enabling automated network management and monitoring through a standardized interface

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add tailscale --env TAILSCALE_API_KEY='<TAILSCALE_API_KEY>' --env TAILSCALE_TAILNET='<TAILSCALE_TAILNET>' -- npx --package=@hexsleeves/tailscale-mcp-server tailscale-mcp-server

~/.codex/config.toml

[mcp_servers.tailscale]
command = "npx"
args = ["--package=@hexsleeves/tailscale-mcp-server", "tailscale-mcp-server"]
env = { TAILSCALE_API_KEY = "<TAILSCALE_API_KEY>", TAILSCALE_TAILNET = "<TAILSCALE_TAILNET>" }

# codex mcp add tailscale --env TAILSCALE_API_KEY='<TAILSCALE_API_KEY>' --env TAILSCALE_TAILNET='<TAILSCALE_TAILNET>' -- npx --package=@hexsleeves/tailscale-mcp-server tailscale-mcp-server

~/.cursor/mcp.json

{
  "mcpServers": {
    "tailscale": {
      "command": "npx",
      "args": [
        "--package=@hexsleeves/tailscale-mcp-server",
        "tailscale-mcp-server"
      ],
      "env": {
        "TAILSCALE_API_KEY": "<TAILSCALE_API_KEY>",
        "TAILSCALE_TAILNET": "<TAILSCALE_TAILNET>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "tailscale": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "--package=@hexsleeves/tailscale-mcp-server",
        "tailscale-mcp-server"
      ],
      "env": {
        "TAILSCALE_API_KEY": "<TAILSCALE_API_KEY>",
        "TAILSCALE_TAILNET": "<TAILSCALE_TAILNET>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "tailscale": {
      "command": "npx",
      "args": [
        "--package=@hexsleeves/tailscale-mcp-server",
        "tailscale-mcp-server"
      ],
      "env": {
        "TAILSCALE_API_KEY": "<TAILSCALE_API_KEY>",
        "TAILSCALE_TAILNET": "<TAILSCALE_TAILNET>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "tailscale": {
      "command": "npx",
      "args": [
        "--package=@hexsleeves/tailscale-mcp-server",
        "tailscale-mcp-server"
      ],
      "env": {
        "TAILSCALE_API_KEY": "<TAILSCALE_API_KEY>",
        "TAILSCALE_TAILNET": "<TAILSCALE_TAILNET>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "tailscale": {
      "command": "npx",
      "args": [
        "--package=@hexsleeves/tailscale-mcp-server",
        "tailscale-mcp-server"
      ],
      "env": {
        "TAILSCALE_API_KEY": "<TAILSCALE_API_KEY>",
        "TAILSCALE_TAILNET": "<TAILSCALE_TAILNET>"
      }
    }
  }
}

Environment variables

TAILSCALE_API_KEY
TAILSCALE_TAILNET

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related