Skip to content
MCP Tools

Give Your AI Assistant
Access to Your Homelab

6 Model Context Protocol servers that connect Claude Desktop, Cursor, Windsurf, and other AI assistants directly to your self-hosted infrastructure. 36 tools. Zero cloud dependencies. 5-minute setup.

6 MCP Servers
36 Total Tools
5 min Setup Time

The Bridge Between AI and Your Services

The Problem

AI assistants are powerful but isolated. They can't see your documents, check your services, or trigger your workflows without you copy-pasting everything back and forth.

The Protocol

Model Context Protocol (MCP) is a standardized way for AI assistants to use external tools. One server works with every compatible client: Claude Desktop, Cursor, Windsurf, and more.

The Result

Ask Claude to search your documents, trigger a workflow, query your knowledge base, or check if a service is healthy. It just does it. No context switching, no copy-paste.

6 Servers. 36 Tools. One Pack.

Each server connects your AI assistant to a specific homelab service.

7 tools

Paperless-ngx

Search documents, manage tags, update metadata

  • Full-text search across all OCR'd documents
  • Get document details, metadata, and content
  • List recent documents and browse tags
  • Update document metadata and assign tags
6 tools

n8n Workflows

List, execute, activate/deactivate workflows

  • List all workflows with status and tags
  • Trigger workflow executions on demand
  • Enable or disable workflows remotely
  • View execution history and results
7 tools

Qdrant Vector DB

Semantic search, upsert vectors, manage collections

  • Semantic similarity search across collections
  • Upsert and manage vector embeddings
  • List and inspect collections with stats
  • Query with metadata filters and thresholds
7 tools

BookStack Wiki

Search pages, get content, create and update pages

  • Full-text search across wiki pages
  • Get page content in markdown or HTML
  • Create new pages in shelves and books
  • Browse shelves, books, and chapters
5 tools

Service Monitoring

Health checks, Uptime Kuma integration, port scanning

  • Check health status of any service endpoint
  • Query Uptime Kuma for monitor statuses
  • Scan ports and detect running services
  • Get aggregate infrastructure overview
4 tools

Homelab Hub

Unified dashboard across all connected services

  • Unified status across all MCP servers
  • Cross-service search and discovery
  • Aggregate stats and service health
  • Quick-access to any connected tool

Up and Running in 3 Steps

1

Install

Install any server with a single npm command. No build step, no Docker, no complex setup.

npm install @duncansmith/mcp-paperless
2

Configure

Add the server to your AI client's config file. Point it at your service URL and set your API key.

claude_desktop_config.json
3

Use

Start asking your AI assistant about your services. It automatically discovers and uses the available tools.

"Search my documents for the vendor invoice"
claude_desktop_config.json
{
  "mcpServers": {
    "paperless": {
      "command": "npx",
      "args": ["@duncansmith/mcp-paperless"],
      "env": {
        "PAPERLESS_URL": "http://paperless.local:8000",
        "PAPERLESS_TOKEN": "your-api-token"
      }
    }
  }
}

Works With Your Favorite AI Client

Built on the open MCP standard. One server, every compatible client.

Claude Desktop
Cursor
Windsurf
Cline
Continue

Built for Real Homelab Use

TypeScript + Zod

Every tool has strict input validation with Zod schemas. Type-safe from end to end, with clear error messages when something is wrong.

Graceful Error Handling

Services down? Network issues? Every tool handles failures gracefully with descriptive messages instead of crashing the MCP connection.

Response Truncation

Large API responses are intelligently truncated to fit within context windows. No more token overflows from a document dump.

Zero Cloud Dependencies

Everything communicates over your local network. Your data never leaves your infrastructure. No third-party APIs, no telemetry, no external calls.

5-Minute Setup

Install with npm, add three lines to your config, and you are done. No containers, no compilation, no complex dependencies.

Free Updates

Buy once, get updates forever. New tools, new features, compatibility fixes, all included with your purchase at no extra cost.

One-Time Purchase. No Subscription.

Pay once, use forever. Free updates included.

Individual Server
$9 one-time

Pick the server you need

  • 1 MCP server of your choice
  • TypeScript + Zod validation
  • Graceful error handling
  • Response truncation built in
  • Free updates for life
Buy Server
Full Pack + Source
$49 one-time

Everything plus full source code

  • Everything in Full Pack
  • Complete TypeScript source
  • Modify and extend freely
  • Build your own MCP servers
  • Priority support via email
Buy with Source

Ready to Connect Your Homelab?

Install an MCP server in 5 minutes and start talking to your infrastructure through AI. Buy once, use forever.