homelab-mcp

general MCP Server

MCP server for Proxmox homelab — 65+ tools across 17 domains. Manage VMs, Docker, media stack, monitoring, storage, and networking from AI assistants.

VerifiedInstall Ready
generalgeneraldocker
4 views5 stars0 forksv2.4.3MIT

Why This Matters

Discovered via github-topic:model-context-protocol and last synced 1w ago.

VerifiedInstall Ready
Source
github-topic:model-context-protocol
Stars
5
Last synced
1w ago
Install
Instructions detected

Install

1. Install the package

npx homelab-mcp

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "homelab-mcp": {
      "command": "npx",
      "args": [
        "homelab-mcp"
      ]
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

122
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (122)

SSH_STRICT_HOST_KEY

`false`

Variable

Default

PROXMOX_CMD_TIMEOUT

`60000`

proxmox_get_logs

Tail task log for a VM/CT

devbox_project_deploy

Deploy: git pull → compose pull → compose up → status

radarr_get_history

Recent download history

sonarr_remove_series

Remove a series (optionally delete files)

sabnzbd_get_status

Download speed, ETA, disk space, queue size

lidarr_add_artist

Add an artist to Lidarr

plex_search

Search across all libraries

seerr_stats

Request statistics

media_dashboard

All-in-one: Proxmox, containers, downloads, library, storage, GPU

uptime_status

Monitor up/down status and latency

adguard_check_host

Check if a domain is blocked

homelab_setup

**AI-guided setup wizard** — configure `.env` through conversation

PROMETHEUS_URL

Prometheus API

Tool

Description

proxmox_exec

Run a shell command on Proxmox host (dangerous commands blocked)

devbox_project_status

Health check for a deployed project

radarr_check_releases

Show available releases and rejections

sonarr_get_queue

Active episode downloads with progress

sabnzbd_list_queue

Active NZB downloads with progress

lidarr_list_artists

List all artists with album counts

plex_get_sessions

Who is streaming, what, transcode/direct play

tautulli_get_activity

Current Plex streams (Tautulli)

nvidia_status

GPU temp, util, VRAM, power

adguard_toggle_protection

Enable/disable DNS filtering

PROXMOX_TLS_VERIFY

`false`

proxmox_start_vm

Start a VM or container

devbox_read_file

Read a file (max 100 KB)

radarr_search_movie

Search for a movie by title

radarr_blocklist_release

Blocklist a bad release and retry

sonarr_check_releases

Show releases and rejections for a season

sabnzbd_resume_queue

Resume downloads

readarr_search_book

Search for a book

plex_delete_media

Permanently delete by ratingKey

bazarr_status

Wanted subtitle counts

prometheus_snapshot

Quick CPU, RAM, disk, network, container health

qnap_storage_usage

Per-share usage and LVM

PBS_TLS_VERIFY

`false`

proxmox_stop_vm

Stop a VM or container

devbox_write_file

Write a file, auto-creates parent dirs (max 1 MB)

radarr_add_movie

Add a movie and trigger download search

radarr_list_path_mappings

List remote path mappings

sonarr_blocklist_release

Blocklist and retry a failed download

sabnzbd_delete_item

Delete a queue item by NZO ID

readarr_add_book

Add a book to Readarr

plex_get_watch_history

Recent watch history across users

bazarr_download_subtitle

Trigger manual subtitle download

prometheus_query

Run an arbitrary PromQL query

qnap_raid_status

RAID array health check

container_check_updates

Check for newer Docker images

MAX_OUTPUT_CHARS

`30000`

HTTP_RETRIES

`3`

proxmox_get_metrics

Detailed metrics for one VM/CT

proxmox_get_node_metrics

Node-level CPU, RAM, disk, load

devbox_docker_ps

Show running Docker containers

devbox_docker_compose

Run compose up/down/restart/pull/logs

radarr_remove_movie

Remove a movie (optionally delete files)

radarr_get_queue

Active movie downloads with progress

sonarr_search_series

Search for a TV series by title

sonarr_add_series

Add a series and trigger download

sonarr_clear_blocklist

Clear the release blocklist

sonarr_list_path_mappings

List remote path mappings

prowlarr_sync_apps

Sync indexers to Radarr/Sonarr

prowlarr_test_indexers

Test all (or one) indexer

readarr_get_queue

Active book downloads

seerr_approve_request

Approve a pending request

seerr_decline_request

Decline a request

media_status

Running container status and uptime

media_logs

Tail logs for a media container

grafana_list_dashboards

List all dashboards

grafana_get_dashboard

Get panel list for a dashboard

pbs_list_snapshots

Recent backup snapshots

pbs_get_tasks

Backup/verify/GC task history

notify_telegram

Send a message to Telegram

homelab_health

Ping all configured services, report reachable/down + latency

DEVBOX_CMD_TIMEOUT

`30000`

proxmox_create_ct

Create a new Debian 12 LXC container

devbox_git

Git status, pull, log, or clone a repo

radarr_force_search

Re-search indexers for a movie

sonarr_list_series

List series with episode progress (filter/search/limit)

sonarr_set_path_mapping

Add/update a path mapping

lidarr_search_artist

Search for a music artist

plex_get_libraries

List Plex libraries with item counts

seerr_delete_request

Delete a request

media_restart

Restart a media container

grafana_query_panel

Query actual data from a panel

adguard_stats

DNS query stats and block rate

homelab_capabilities

**Start here** — lists all available tools

proxmox_list_nodes

List Proxmox nodes with CPU, RAM, uptime

devbox_project_list

Scan a base path for compose projects

radarr_clear_queue

Remove all items from download queue

sonarr_force_search

Re-search for missing episodes

sabnzbd_get_history

Recent download history

lidarr_remove_artist

Remove an artist

plex_recently_added

Recently added movies and episodes

tautulli_get_history

Plex watch history (Tautulli)

security_status

SSH config and Proxmox firewall status

qnap_status

QNAP NAS: RAID, drive temps, storage

wol_send

Wake-on-LAN magic packet

proxmox_list_vms

List all VMs and LXC containers

devbox_exec

Run a shell command on the devbox (dangerous commands blocked)

radarr_clear_blocklist

Clear the release blocklist

sonarr_season_search

Search for a specific season

sabnzbd_pause_queue

Pause downloads

lidarr_get_queue

Active music downloads

plex_refresh_library

Trigger a library scan

tautulli_get_stats

30-day play stats

qnap_disk_health

SMART health per drive

tailscale_status

Tailscale peers and status

proxmox_restart_vm

Restart a VM or container

devbox_list_dir

List directory contents

radarr_list_movies

List movies with download status (filter/search/limit)

radarr_set_path_mapping

Add/update a path mapping

sonarr_clear_queue

Clear the download queue

prowlarr_list_indexers

List indexers with status

readarr_list_books

List all books

seerr_list_requests

List media requests from family

prometheus_range_query

Historical metric trends

pbs_status

PBS datastore usage

container_update

Pull + restart a container