mcp-tailscale
The mcp-tailscale server provides read-only monitoring and inspection of your Tailscale network (tailnet) through the following tools:
List all devices (
tailscale_list_devices): Retrieve all devices in your tailnet with details like name, hostname, IP addresses, OS, and connection status; optionally filter which fields to returnGet a specific device (
tailscale_get_device): Look up detailed information about a single device by its numeric ID or nameList online devices (
tailscale_list_online_devices): View only devices currently connected to the Tailscale control planeList offline devices (
tailscale_list_offline_devices): View only devices that are currently disconnected or offlineCheck for updates (
tailscale_check_updates): Identify which devices have Tailscale client updates availableGet a network summary (
tailscale_device_summary): Get an overview of your tailnet broken down by OS type, online/offline status, and update availability
Allows managing a Tailscale network (tailnet) by listing devices, checking online/offline status, monitoring connection health, viewing available client updates, and retrieving network summary statistics.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-tailscaleWhich of my devices are currently online?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-tailscale
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
Related MCP server: mcp-tailscale
Available Tools
Tool | Description |
| List all devices in your tailnet |
| Get details about a specific device |
| List only online/connected devices |
| List only offline/disconnected devices |
| Check which devices need updates |
| Get summary stats (online/offline, by OS, etc.) |
Installation
npm install
npm run buildConfiguration
Environment Variables
TAILSCALE_API_KEY- Required. Your Tailscale API key from https://login.tailscale.com/admin/settings/keysTAILSCALE_TAILNET- Optional. Defaults to-(your current user's tailnet)
Get an API Key
Click "Generate auth key"
Configure:
Expiry: Choose duration (1-90 days)
Description: "MCP Server"
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 networkDevelopment
# Build
npm run build
# Watch mode
npm run watch
# Test locally
TAILSCALE_API_KEY=your-key node dist/index.jsAPI 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
Website: jimchristian.net
GitHub: @aplaceforallmystuff
Links
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceAn MCP (Model Context Protocol) server for managing Tailscale resources using the official Tailscale Go client library v2. This server provides complete coverage of the Tailscale API with enhanced, self-descriptive tools powered by OpenAPI documentation.Last updated2MIT
- AlicenseAqualityDmaintenanceProduction-ready MCP server for Tailscale management with 48 tools across 9 domains: Devices, DNS/Split DNS, ACL policies, Auth Keys, Users, Webhooks, Posture Integrations, Tailnet Settings, and Diagnostics. Supports stdio and SSE transport with Bearer token authentication. Built with TypeScript strict mode, Zod validation, and zero shell execution. AGPL-3.0 + Commercial dual-licensed.Last updated491311AGPL 3.0
- Flicense-qualityDmaintenanceA secure MCP server for network diagnostics, providing tools like ping, traceroute, whois, nslookup, dig, nmap, curl, and netstat through natural language interfaces.Last updated
- Alicense-qualityCmaintenanceWraps the Tailscale CLI to enable MCP-capable AI agents to manage devices, serve configurations, and diagnose connectivity.Last updated3MIT
Related MCP Connectors
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
MCP server for Gainium — manage trading bots, deals, and balances via AI assistants
GibsonAI MCP server: manage your databases with natural language
Appeared in Searches
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/aplaceforallmystuff/mcp-tailscale'
If you have feedback or need assistance with the MCP directory API, please join our Discord server