KeyShot MCP Server

by truman-t3io.github.truman-t3/keyshot-mcpv0.13.0

Control local KeyShot scenes, cameras, environments, and renders through headless scripting.

19Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active9d ago

Install KeyShot MCP server

claude mcp add keyshot -e KEYSHOT_HEADLESS_EXE='<keyshot-headless-exe>' -- npx -y keyshot-mcp

{
  "mcpServers": {
    "keyshot": {
      "command": "npx",
      "args": [
        "-y",
        "keyshot-mcp"
      ],
      "env": {
        "KEYSHOT_HEADLESS_EXE": "<keyshot-headless-exe>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "keyshot": {
      "command": "npx",
      "args": [
        "-y",
        "keyshot-mcp"
      ],
      "env": {
        "KEYSHOT_HEADLESS_EXE": "<keyshot-headless-exe>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "keyshot": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "keyshot-mcp"
      ],
      "env": {
        "KEYSHOT_HEADLESS_EXE": "<keyshot-headless-exe>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "keyshot": {
      "command": "npx",
      "args": [
        "-y",
        "keyshot-mcp"
      ],
      "env": {
        "KEYSHOT_HEADLESS_EXE": "<keyshot-headless-exe>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
KEYSHOT_HEADLESS_EXE	yes	—	Absolute path to KeyShot headless, or a command available on PATH.
KEYSHOT_OUTPUT_DIR	—	—	Root directory for rendered images and saved scenes.
KEYSHOT_ALLOW_EXTERNAL_OUTPUTS	—	—	Set to true only when output paths outside KEYSHOT_OUTPUT_DIR are required.
KEYSHOT_TIMEOUT_MS	—	—	Timeout in milliseconds for one KeyShot headless process.
KEYSHOT_LICENSE_ARGS	—	—	Optional additional KeyShot launch arguments.
KEYSHOT_MATERIAL_PRESETS	—	—	Optional path to a user-managed material preset JSON file.
KEYSHOT_CAMERA_PRESETS	—	—	Optional path to a user-managed camera preset JSON file.

Freshness

Active — last maintenance signal 9d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-30 · 9d ago · GitHub
Latest release
2026-09-30 · 9d ago · GitHub · v0.13.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-30 · 9d ago · official registry · v0.13.0

FAQ

›How do I install the KeyShot MCP server in Claude Code?

Run: claude mcp add keyshot -e KEYSHOT_HEADLESS_EXE='<keyshot-headless-exe>' -- npx -y keyshot-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does KeyShot require an API key?

Yes. It expects KEYSHOT_HEADLESS_EXE.

›Can I use KeyShot as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is KeyShot in the official MCP registry?

Yes, as io.github.truman-t3/keyshot-mcp.