Linode MCP Server

A Model Context Protocol (MCP) server for interacting with Linode's API to manage cloud resources. This package enables Large Language Models (LLMs) like Claude to manage Linode instances through a standardized interface.

Features

• List Linode regions, instance types, and instances

• Create, view details, delete, and reboot Linode instances

• Secure and easy-to-use interface for LLMs to manage Linode resources

• Fully compatible with MCP-enabled AI assistants like Claude

Installation and Configuration

Set your Linode API key as an environment variable:

Or use a .env file in the project directory:

You can generate an API key from the Linode Cloud Manager.

From PyPI (Recommended)

Using uv

From Source

Usage

As a Command Line Tool

With Claude for Desktop

1. Install the package:

   pip install linode-mcp

2. Manually edit your Claude Desktop configuration file:

   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   { "mcpServers": { "linode": { "command": "linode-mcp", "args": ["--api-key", "your_api_key_here"] } } }

3. Restart Claude for Desktop

4. In a conversation with Claude, you can now ask it to:

   • List your Linode instances

   • Create a new Linode instance

   • Get details about a specific instance

   • Reboot or delete instances

Example prompts:

• "Show me all my Linode instances"

• "Create a new 2GB Linode in the Frankfurt region with Debian 11"

• "Reboot my instance with ID 12345"

Available Tools

The package provides these MCP tools:

• list_regions - List all available Linode regions

To be added:

• list_instance_types - List all available Linode instance types and their pricing

• list_instances - List all existing Linode instances

• create_instance - Create a new Linode instance

• get_instance - Get details about a specific Linode instance

• delete_instance - Delete a Linode instance

• reboot_instance - Reboot a Linode instance

Development

Project Structure

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository

2. Create your feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add some amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Linode API for providing the cloud infrastructure API

• Model Context Protocol for the standard interface specification

• Claude for AI assistant capabilities