NovelAI Image MCP Server: Install & Setup

Install NovelAI Image in Claude Code

PyPI (uv)

Claude Code

claude mcp add novelai-image -e NOVELAI_TOKEN=... -- uvx novelai-image-mcp

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "novelai-image": {
      "command": "uvx",
      "args": [
        "novelai-image-mcp"
      ],
      "env": {
        "NOVELAI_TOKEN": "..."
      }
    }
  }
}

Docker

Claude Code

claude mcp add novelai-image -e NOVELAI_TOKEN=... -- docker run -i --rm -e NOVELAI_TOKEN ghcr.io/xinvxueyuan/novelai-image-mcp:0.7.1

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "novelai-image": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "NOVELAI_TOKEN",
        "ghcr.io/xinvxueyuan/novelai-image-mcp:0.7.1"
      ],
      "env": {
        "NOVELAI_TOKEN": "..."
      }
    }
  }
}

Replace each ... with your own value.

Frequently asked questions

What does the NovelAI Image MCP server do?

NovelAI image generation as MCP tools: txt2img, img2img, inpaint, upscale, Director, ControlNet.

Is the NovelAI Image MCP server free?

The server is free, but you will likely need an account. The server itself is free, but it connects to a service that needs an account or API key, which may have paid tiers. Check the provider for current pricing.

Does NovelAI Image run locally or remotely?

Local. Runs on your machine (stdio). You install it with npx, uvx, Docker or from source.

How do I add NovelAI Image to Claude Code?

Run: claude mcp add novelai-image -e NOVELAI_TOKEN=... -- uvx novelai-image-mcp

More multimedia, audio & video MCP servers

View all

Whisper

3281

jwulff/whisper-mcp

Local audio transcription using whisper.cpp. Transcribe with OpenAI Whisper models.

LocalFree

GPT Image

0352

youbotapi/gpt-image-mcp

Generate and edit images with GPT Image 2.5 for $0.029 — free key, 50 credits, no card.

LocalPaid service

Image to SVG

botmonster/image2svg-mcp

Convert raster images (PNG, JPG, WebP, TIFF) to SVG from base64 or URL input, locally or via Docker.

LocalFreePython

Clueso

clueso-ai/clueso-mcp

Make videos and docs with your AI agent — describe what you need, every output stays editable.

RemoteAccount needed

Mediamcp

4206

legolev/mediamcp

Image generation and editing plus Veo, Sora and Seedance video generation via OpenRouter or OpenAI-compatible APIs, with resumable video jobs.

LocalAccount neededTypeScript

Yueying

vsh5dvsch7-png/yueying

Local videos or YouTube/Bilibili URLs -> timestamped transcript, keyframes, contact sheets. Offline.

LocalFree