Linode MCP Server

Linode MCP Server

An MCP (Model Context Protocol) server that connects your AI Assistant or Agent to your Linode cloud infrastructure allowing you to manage your cloud resources through natural conversation. Built with FastMCP framework and supports stdio, SSE, and HTTP streaming transports!

What Can You Do With This?

Ask Claude Desktop or VSCode Copilot Agent to help you with tasks like:

• "Show me all my instances in the Frankfurt region"
• "Create a new instance in Osaka"
• "Create a load balancer for my web servers"
• "Set up a managed MySQL database" etc

This server provides tools for the following Linode service categories:

• 🖥️ instances - Linode compute instances
• 💾 volumes - Block storage volumes
• 🌐 networking - IP addresses, firewalls, VLANs
• ⚖️ nodebalancers - Load balancers for distributing traffic
• 🌎 regions - Data center locations
• 📊 placement - Instance placement policies
• 🔒 vpcs - Virtual Private Cloud networks
• 📦 objectStorage - S3-compatible object storage
• 🔤 domains - DNS management
• 🗄️ databases - Managed MySQL/PostgreSQL databases
• ☸️ kubernetes - Kubernetes container orchestration (LKE)
• 💿 images - Custom disk images for instances
• 📜 stackScripts - Deployment automation scripts
• 🏷️ tags - Resource organization labels
• 🎫 support - Support tickets and requests
• 📊 longview - System metrics and monitoring
• 👤 profile - User profile and security settings
• 🏢 account - Account management, users, and billing

Getting Started

Quick Start with npx

You'll need a Linode API token to use this server. Create one in your Linode Cloud Manager profile settings.

# Start the server with your API token
npx @takashito/linode-mcp-server --token YOUR_LINODE_API_TOKEN

Setting Your API Token

You can provide your token in several ways:

1. Command line option:

   npx @takashito/linode-mcp-server --token YOUR_LINODE_API_TOKEN
   

2. Environment variable:

   export LINODE_API_TOKEN=your_token_here
   npx @takashito/linode-mcp-server
   

3. Environment file: Create a .env file in your project directory with:

   LINODE_API_TOKEN=your_token_here
   

   Then run:

   npx @takashito/linode-mcp-server
   

Connecting to AI Clients

Claude Desktop

Open Claude settings > Developer > Edit Config:

{
  "mcpServers": {
    "linode": {
      "command": "npx",
      "args": ["-y", "@takashito/linode-mcp-server", "--token", "YOUR_LINODE_API_TOKEN"]
    }
  }
}

VSCode/Cursor/Windsurf

Add to your settings.json:

{
  "mcpServers": {
    "linode": {
      "command": "npx",
      "args": ["-y", "@takashito/linode-mcp-server", "--token", "YOUR_LINODE_API_TOKEN", "--categories", "instances,volumes,regions"]
    }
  }
}

⚠️ Note: For GPT-4o based clients, use --categories to limit tools and avoid context window errors.

Automatic Installation via Smithery to Claude Desktop

For the easiest setup, use Smithery:

npx -y @smithery/cli install @takashito/linode-mcp-server --client claude

Tools Category Selection

You can selectively enabled tools with --categories parameter:

# Enable only instances and volumes tools
npx @takashito/linode-mcp-server --token YOUR_TOKEN --categories instances,volumes

Or in Claude Desktop config:

{
  "mcpServers": {
    "linode": {
      "command": "npx",
      "args": [
        "-y",
        "@takashito/linode-mcp-server",
        "--token", 
        "YOUR_LINODE_API_TOKEN",
        "--categories",
        "instances,volumes,regions"
      ]
    }
  }
}

Available categories: instances, volumes, networking, nodebalancers, regions, placement, vpcs, objectStorage, domains, databases, kubernetes, images, stackScripts, tags, support, longview, profile, account

To see all available categories:

npx @takashito/linode-mcp-server --list-categories

Transport Options

1. stdio transport - Default transport compatible with Claude Desktop

   # Default stdio transport
   npx @takashito/linode-mcp-server --token YOUR_TOKEN
   

2. SSE transport - Server-Sent Events transport for web clients

   # Start with SSE transpor