Connect MeiGen MCP

For ChatGPT, install MeiGen from the official ChatGPT store and sign in. Other users should add the Streamable HTTP server https://www.meigen.ai/api/mcp in an OAuth-capable MCP host, then choose Connect / Authenticate and approve the MeiGen account connection. No API key or Node.js is needed. See remote setup for Claude, Codex, Cursor and other compatible hosts. If the host cannot authenticate with OAuth, use a compatible client or the official ChatGPT plugin. API keys are only retained for existing legacy integrations, not offered as an alternative for new users. Do not paste credentials into chat. Private favorites, boards, history, prompt details and saving are available through standard remote MCP with OAuth. Local npm and API keys cannot access them. Refresh the host’s tool list after connecting; store listing review and runtime discovery are separate.

Ask an assistant to connect

Connect MeiGen MCP at https://www.meigen.ai/api/mcp with remote OAuth.
Preserve other servers and reuse an existing MeiGen entry. When switching from a
fixed API key, remove its Authorization header and let me sign in through the host.
Do not create a new API key or ask for credentials in chat. Keep a working legacy
or BYOK setup only when needed, and do not add duplicate MeiGen tools.
After reconnecting, call list_skills and report the result. Do not upload,
generate or spend credits just to verify setup. Explain any unverified step.

Existing local integrations and BYOK

The following configuration is for maintaining an existing stdio/API-key integration or an explicitly selected OpenAI-compatible image provider. Local npm has no OAuth login and does not expose private account-library tools. It can prepare readable local files, save ordinary generation results, enhance prompts and store machine-local preferences.

npm 3.3.3 is the current release. Before upgrading, read the 3.0 migration notes: ComfyUI and the bundled prompt library are removed, with no offline search fallback. The examples below pin this version explicitly. Midjourney content/style reference selection and advanced niji7Options require local 3.3.3 or later; hosted connections should refresh their tool list. HeyGen reference videos require 3.1.1 or later; earlier local versions misread its per-clip and total duration limits.

Node.js 22+ is recommended. Preserve an existing key privately as MEIGEN_API_TOKEN; do not create a new MeiGen key for these examples. The snippets below show relevant fields only; do not replace an existing entry or configuration file with them.

{
  "mcpServers": {
    "meigen": {
      "command": "npx",
      "args": ["-y", "meigen@3.3.3"]
    }
  }
}

Set existing credentials in the MCP process environment or host private settings, not in shared JSON. Private local configuration at ~/.config/meigen/config.json remains compatible. Changes require restarting/reconnecting the host.

Existing editor connections

For an existing Cursor, VS Code, Windsurf, Roo or Claude connection, edit its MeiGen entry manually. Change only the package argument in args to meigen@3.3.3; preserve the command, other arguments, env, environment forwarding, timeouts, host-specific settings and all other MCP entries. Keep any existing private credentials in place. Do not run the published 2.0.2 initializer against existing configuration: it can replace the MeiGen entry rather than preserve its settings. If the command uses an unfamiliar wrapper or has no identifiable MeiGen package argument, leave it unchanged and inspect that host’s configuration before editing. Keep an explicit version pin instead of an unversioned package or @latest to avoid an unintended future major upgrade. New connections use remote OAuth.

Existing Codex stdio configuration

New users should use remote OAuth. Existing local integrations can keep this entry instead of a duplicate remote entry:

[mcp_servers.meigen]
command = "npx"
args = ["-y", "meigen@3.3.3"]
env_vars = ["MEIGEN_API_TOKEN"]
startup_timeout_sec = 90
tool_timeout_sec = 240

The host must inherit the existing variable; a project .env.local is not automatically loaded. Omit env_vars for anonymous public discovery if no variable exists. Longer video jobs may need more time; recover interrupted tasks with the original generationId or persisted requestId instead of starting a new paid attempt.

Existing Claude and OpenClaw plugins

The Claude marketplace plugin and OpenClaw bundle 3.x use local stdio. The OpenClaw 4.0 ClawHub plugin defaults to remote OAuth; saved local/BYOK overrides are not automatically migrated. Back up and inspect the existing connection before choosing to switch. Keep one active MeiGen server and preserve legacy credentials privately. Distribution versions and instructions update separately from npm. The standalone ClawHub Skill is guidance only, and is already included in the plugin.

Hermes Agent (NousResearch)

New MeiGen connections should use remote OAuth. For an existing local Hermes integration that waits for long video jobs, merge these timeouts into its ~/.hermes/config.yaml entry, keeping its existing private environment settings:

mcp_servers:
  meigen:
    command: "npx"
    args: ["-y", "meigen@3.3.3"]
    timeout: 2700
    connect_timeout: 120

timeout: 2700 allows up to 45 minutes for a tool call; connect_timeout: 120 allows time for the first npm download. They are suggested settings for long waits, not a generation deadline or completion guarantee. See Hermes MCP configuration. A host timeout does not cancel or refund an accepted task. Prefer wait: false with a persisted UUID requestId and download: false for composed jobs. Recover with check_generation using the original generationId or requestId; if resubmission is required, preserve that ID and exact inputs. See workflow recovery.

Legacy CLI

An existing CLI integration may continue using its privately configured MEIGEN_API_TOKEN:

npx -y meigen@3.3.3 gen --prompt "a ceramic coffee mug in soft window light"
npx -y meigen@3.3.3 gen -p "product hero shot" --ref ~/Desktop/bottle.jpg
npx -y meigen@3.3.3 gen --help

These generation examples are paid actions, not connection tests. --json returns structured output; --no-wait submits without polling. Preserve returned task IDs and exact inputs for recovery.

OpenAI-compatible ordinary images

For an explicitly selected BYOK provider, retain OPENAI_API_KEY, OPENAI_BASE_URL and OPENAI_MODEL in private local settings. Use that provider’s supported models and billing. BYOK does not provide MeiGen videos, the five dedicated Skills or private library access. In 3.0.0, local provider priority is MeiGen (existing legacy key), then OpenAI-compatible; the removed ComfyUI provider is rejected rather than redirected to a paid provider.

Output directories

Ordinary local generation and CLI calls can save results. Dedicated Skills return URLs/resources; download them explicitly if needed.

Type	Default	Override	Linux fallback
Images	`~/Pictures/meigen/`	`MEIGEN_OUTPUT_DIR`	`XDG_PICTURES_DIR`
Videos	`~/Movies/meigen/`	`MEIGEN_VIDEO_OUTPUT_DIR`	`XDG_VIDEOS_DIR`

Verify and recover

After connecting, ask “List MeiGen’s available Skills and current prices” and verify a successful list_skills call. This public check does not prove account authorization or paid balance. Do not generate merely to test a connection. For missing authorization, reconnect through OAuth. For existing legacy integrations only, privately check the configured key. For insufficient credits, use the connected account’s Profile → Top Up; generation uses purchased credits, not daily free credits. Follow actual list_models / list_skills prices. An interrupted ordinary task uses check_generation; a Skill uses check_skill with its original receipt and exact inputs. Follow returned actions for upload errors, resize consent, price changes and refunds. See the workflow contract and Skills guide.

Getting Started

Features

MCP Plugin

Account

Ask an assistant to connect

Existing local integrations and BYOK

Existing editor connections

Existing Codex stdio configuration

Existing Claude and OpenClaw plugins

Hermes Agent (NousResearch)

Legacy CLI

OpenAI-compatible ordinary images

Output directories

Verify and recover

​New connection: use account sign-in

​Ask an assistant to connect

​Existing local integrations and BYOK

​Existing editor connections

​Existing Codex stdio configuration

​Existing Claude and OpenClaw plugins

​Hermes Agent (NousResearch)

​Legacy CLI

​OpenAI-compatible ordinary images

​Output directories

​Verify and recover

New connection: use account sign-in

Ask an assistant to connect

Existing local integrations and BYOK

Existing editor connections

Existing Codex stdio configuration

Existing Claude and OpenClaw plugins

Hermes Agent (NousResearch)

Legacy CLI

OpenAI-compatible ordinary images

Output directories

Verify and recover