1. Conduid
  2. Developer Tools
  3. Tailscale
MCP server · Developer Tools

Tailscale

by · github.com/aplaceforallmystuff/mcp-tailscale

MCP server for managing your Tailscale network (tailnet) through Claude Code and other MCP clients

Unclaimed MIT productivity
InstallView source
62Good

Scored yesterday · breakdown

About Tailscale

Tailscale is an MCP server published by aplaceforallmystuff in the Developer Tools category: mCP server for managing your Tailscale network (tailnet) through Claude Code and other MCP clients.

The repository has 7 stars and 1 forks, with the last commit 2 months ago. Recent commit activity is the strongest signal that reported issues will get attention.

Install

Claude Code
claude mcp add tailscale -- npx -y @tailscale-mcp/tailscale-mcp
npx
npx -y @tailscale-mcp/tailscale-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (6)

tailscale_check_updatesCheck which devices need updates

Parameters not published.

tailscale_device_summaryGet summary stats (online/offline, by OS, etc.)

Parameters not published.

tailscale_get_deviceGet details about a specific device

Parameters not published.

tailscale_list_devicesList all devices in your tailnet

Parameters not published.

tailscale_list_offline_devicesList only offline/disconnected devices

Parameters not published.

tailscale_list_online_devicesList only online/connected devices

Parameters not published.

Ask AI

✦

Ask AI about Tailscale

Powered by Claude · Grounded in docs

I know everything about Tailscale. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 6 hours ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

Releases

v1.0.0v1.0.0

README

mcp-tailscale

npm version CI MCP

MCP server for managing your Tailscale network (tailnet) through Claude Code and other MCP clients.

Features

  • List Devices - View all devices in your tailnet with detailed information
  • Device Status - Check online/offline status and connection health
  • Update Management - See which devices have Tailscale client updates available
  • Network Summary - Get overview statistics of your tailnet
  • Device Search - Find specific devices by ID, name, or hostname

Available Tools

Tool Description
tailscale_list_devices List all devices in your tailnet
tailscale_get_device Get details about a specific device
tailscale_list_online_devices List only online/connected devices
tailscale_list_offline_devices List only offline/disconnected devices
tailscale_check_updates Check which devices need updates
tailscale_device_summary Get summary stats (online/offline, by OS, etc.)

Installation

npm install
npm run build

Configuration

Environment Variables

Get an API Key

  1. Go to https://login.tailscale.com/admin/settings/keys
  2. Click "Generate auth key"
  3. Configure:
    • Expiry: Choose duration (1-90 days)
    • Description: "MCP Server"
  4. Copy the key (starts with tskey-api-)

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "tailscale": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-tailscale/dist/index.js"],
      "env": {
        "TAILSCALE_API_KEY": "tskey-api-your-key-here"
      }
    }
  }
}

Claude Code Configuration

claude mcp add mcp-tailscale --type stdio
claude mcp config mcp-tailscale command "node"
claude mcp config mcp-tailscale args '["'$(pwd)'/dist/index.js"]'
claude mcp config mcp-tailscale env.TAILSCALE_API_KEY "tskey-api-your-key-here"

Usage Examples

List All Devices

Can you list all my Tailscale devices?

Check Online Devices

Which of my Tailscale devices are currently online?

Check for Updates

Do any of my Tailscale devices need updates?

Get Device Details

Show me details about my device named "COMPY"

Network Summary

Give me a summary of my Tailscale network

Development

# Build
npm run build

# Watch mode
npm run watch

# Test locally
TAILSCALE_API_KEY=your-key node dist/index.js

API Permissions

This MCP server uses read-only API calls. It does not modify your Tailscale configuration. The API key only needs:

  • Device list access
  • Device status access

Security Notes

  • API keys are case-sensitive
  • Keys expire based on the duration you set
  • Store keys securely (never commit to version control)
  • Use environment variables or secure configuration management

Changelog

See CHANGELOG.md for version history and release notes.

License

MIT License - see LICENSE for details.

Author

Jim Christian

Links

README fetched from the repository 6 hours ago. The original is authoritative.

Questions

About Tailscale

How do I install Tailscale?

Run claude mcp add tailscale -- npx -y @tailscale-mcp/tailscale-mcp, then add the server to your MCP client's configuration.

Is Tailscale safe to use with an AI agent?

Its trust score is 62 out of 100 (good). It passes 4 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Tailscale still maintained?

Yes — the last commit was 2 months ago. The repository has 7 stars and 1 forks and 5 open issues.