Gesso: a headless, agent-first image engine

1. 1Download gesso-0.11.0.mcpb
2. 2Double-click it and click Install
3. 3Choose a folder for your files, default ~/Documents/Gesso

Prefer editing the config? Node 22+

Open Settings › Developer › Edit Config, add this entry, then quit Claude Desktop completely and reopen it. If the file already lists servers, add "gesso" next to them.

{
  "mcpServers": {
    "gesso": {
      "command": "npx",
      "args": ["-y", "gesso-mcp"],
      "env": { "GESSO_WORKDIR": "~/Documents/Gesso" }
    }
  }
}

$ claude mcp add gesso -- npx -y gesso-mcp

1. 1Run the command
2. 2Start claude in the folder you want Gesso to use
3. 3Run /mcp and check gesso is connected

{
  "mcpServers": {
    "gesso": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "gesso-mcp"],
      "env": { "GESSO_WORKDIR": "~/Documents/Gesso" }
    }
  }
}

For a single project, use .cursor/mcp.json in that project instead.

1. 1Add the entry to mcp.json
2. 2Open Cursor Settings › MCP
3. 3Check gesso is listed and enabled

$ code --add-mcp '{"name":"gesso","type":"stdio","command":"npx","args":["-y","gesso-mcp"],"env":{"GESSO_WORKDIR":"~/Documents/Gesso"}}'

Or run MCP: Add Server from the Command Palette, choose Command (stdio) and enter npx -y gesso-mcp.

1. 1Run the command
2. 2Open Copilot Chat in Agent mode
3. 3Find Gesso in the tools picker

{
  "mcpServers": {
    "gesso": {
      "command": "npx",
      "args": ["-y", "gesso-mcp"],
      "env": { "GESSO_WORKDIR": "~/Documents/Gesso" }
    }
  }
}

For a single project, use .gemini/settings.json in that project instead.

1. 1Add the entry to settings.json
2. 2Start gemini
3. 3Run /mcp to see Gesso's tools

mcp_servers:
  gesso:
    command: "npx"
    args: ["-y", "gesso-mcp"]
    env:
      GESSO_WORKDIR: "~/Documents/Gesso"

1. 1Add it to the mcp_servers block
2. 2Start hermes chat, or run /reload-mcp
3. 3Use the tools, named mcp_gesso_<tool>

There's no official hosted Gesso for claude.ai yet. You can self-host today: Gesso has a hosted mode you run yourself, then add it as a custom connector.

There's no official hosted Gesso for ChatGPT yet. You can self-host today: run Gesso's hosted mode yourself, then add it as a developer-mode app.