NovelAI MCP Server

Русская версия

An MCP server that lets Claude, Cursor and other MCP clients generate and edit images with NovelAI.

Supports NovelAI Diffusion V5 (Full and Curated) and V4.5: text-to-image, img2img, inpainting, Director Tools, Vibe Transfer, upscaling and tag suggestions.

This is an unofficial project. It is not affiliated with or endorsed by NovelAI / Anlatan.

Tools

Generated images are saved to disk and also returned to the client, so the model can see them.

Requirements

• A NovelAI subscription and a Persistent API Token: NovelAI → Settings → Account → Persistent API Tokens.
• uv. It runs the server without a manual install.

Cost

Requests spend your Anlas the same way the NovelAI website does. Large sizes, more steps, upscale and Vibe Transfer cost more. Check your Anlas balance before running many generations. The server does not limit spending.

Setup

Claude Code

claude mcp add novelai -e NOVELAI_API_KEY=your_token -- uvx mcp-server-novelai

Claude Desktop

Edit claude_desktop_config.json:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "novelai": {
      "command": "uvx",
      "args": ["mcp-server-novelai"],
      "env": {
        "NOVELAI_API_KEY": "your_token"
      }
    }
  }
}

Restart Claude Desktop after editing.

Cursor

Add the same mcpServers block to .cursor/mcp.json or to Settings → MCP.

Install from GitHub instead of PyPI

Replace "args": ["mcp-server-novelai"] with:

"args": ["--from", "git+https://github.com/DesmondFox/novelai-mcp", "mcp-server-novelai"]

Configuration

Usage

Ask the model in plain language. It picks the tool and parameters. Examples:

• "Generate a portrait of a girl with silver hair and blue eyes in a sunflower field."
• "Make a chibi cat girl holding a coffee mug, transparent background."
• "Draw a tavern scene: a knight girl on the left, a mage boy on the right."
• "Cyberpunk storefront at night with a neon sign that says NEON DREAMS."
• "Take ~/Pictures/NovelAI/t2i_20260101_120000_abc123.png and change her expression to smug."
• "Remove the background from that image, then upscale it."
• "Suggest tags for 'kimono'."

Useful parameters of novelai_generate_image:

Development

git clone https://github.com/DesmondFox/novelai-mcp
cd novelai-mcp
pip install -e ".[dev]"
pytest
ruff check .

For local development you can put the key in a .env file (see .env.example) instead of the client config.

License

MIT