tinymediamanager-mcp

MCP server for tinyMediaManager HTTP API automation.

Table of Contents

• Features
• Requirements
• Installation
• Configuration
• Quick Start
• Tools
• Troubleshooting
• Security Notes

Features

• Wraps tMM API into MCP tools
• Includes run_workflow for new scope reliability

Requirements

• tinyMediaManager 4.3+
• Node.js 18+

Installation

npm install
npm run build

Configuration

• TMM_HOST (default localhost)
• TMM_PORT (default 7878)
• TMM_API_KEY (required)

Quick Start

TMM_API_KEY=your-key claude mcp add tinymediamanager -- node /path/to/dist/index.js

Tools

run_workflow, update_library, scrape_metadata, rename_media, download_subtitles, download_artwork, download_trailers, fetch_ratings, reload_media_info, export_library

Troubleshooting

• empty scrape on new: use run_workflow
• auth errors: verify API key

Security Notes

• keep API key in env vars