NovelAI Image MCP — Claude Code MCP server
Connects NovelAI image generation to an AI agent through MCP. Use it to create, edit, inpaint, and upscale images from an agent session.
claude mcp add novelai-image-mcp -e NOVELAI_TOKEN=<NOVELAI_TOKEN> -- uvx novelai-image-mcpWhat NovelAI Image MCP does
NovelAI Image MCP exposes NovelAI image operations as MCP tools. An agent can create pictures from text, transform an existing image, fill selected areas, and upscale output by 4×. The server also includes Director actions for line art, emotion, and background removal, plus ControlNet annotation, tag suggestions, and vibe encoding.
Results arrive as base64 image content and as PNG files saved on disk. Local agents can use stdio; remote or multi-client setups can use HTTP with optional bearer-token protection. Image generation requires NOVELAI_TOKEN, or NOVELAI_USERNAME together with NOVELAI_PASSWORD.
What it helps with
- create an image from a text prompt
- transform an existing image with img2img
- fill a selected image area with inpaint
- upscale an image by 4×
- apply Director or ControlNet processing
Example prompts for the agent
- Create a rainy night city image with soft lighting and a cinematic composition.
- Edit the existing image while keeping its composition, but replace the background with a snowy forest.
- Upscale this image by 4× and return the resulting PNG file.
How to install NovelAI Image MCP
Platform CLI
claude mcp add novelai-image-mcp -e NOVELAI_TOKEN=<NOVELAI_TOKEN> -- uvx novelai-image-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from novelai-image-mcp <command>
Platform CLI
codex mcp add novelai-image-mcp --env NOVELAI_TOKEN=<NOVELAI_TOKEN> -- uvx novelai-image-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from novelai-image-mcp <command>
Config file
{
"mcpServers": {
"novelai-image-mcp": {
"command": "uvx",
"args": [
"novelai-image-mcp"
],
"env": {
"NOVELAI_TOKEN": "<NOVELAI_TOKEN>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from novelai-image-mcp <command>
Config file
{
"servers": {
"novelai-image-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"novelai-image-mcp"
],
"env": {
"NOVELAI_TOKEN": "<NOVELAI_TOKEN>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from novelai-image-mcp <command>
Platform CLI
gemini mcp add -e NOVELAI_TOKEN=<NOVELAI_TOKEN> novelai-image-mcp uvx novelai-image-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from novelai-image-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about NovelAI Image MCP
How do I install NovelAI Image MCP in Claude Code?
Run claude mcp add novelai-image-mcp -e NOVELAI_TOKEN=<NOVELAI_TOKEN> -- uvx novelai-image-mcp.
What does NovelAI Image MCP do?
It gives an AI agent NovelAI tools for txt2img, img2img, inpaint, upscaling, Director actions, and ControlNet annotation.
Which connection transports does it support?
It supports stdio for local agents and HTTP for remote or multi-client use. HTTP connections can require a bearer token.
