Morfiade MCP server

Morfiade MCP

<!-- mcp-name: io.github.morfiade-app/morfiade-mcp -->

MCP server for local Google Chrome profiles on Windows. 18 tools that let an AI agent list, create, launch and organise real Chrome profiles on your own machine — each with its own cookies, sessions and proxy.

The server is not a package you download: it ships inside Morfiade, the Chrome profile manager itself, and starts with a flag. Transport is stdio (JSON-RPC 2.0), protocol version 2025-11-25. Nothing is fetched from the internet, nothing passes through anyone else's server.

This repository is the documentation, the ready-made client configs and an optional launcher. Русская версия — README.ru.md.

What makes it different

The bridge lives in the program. AdsPower and GoLogin publish MCP servers as separate packages that talk to their cloud. Morfiade keeps profiles on your disk, so the bridge stays on your disk too: Morfiade.exe --mcp, over the loopback interface, no network required.

Distributing values across windows. The tools with no equivalent elsewhere are syncsets / syncspread / sync_insert: a list of values — emails, logins, anything line-based — is split across the open windows, one value pinned per profile. A repeat call does not reshuffle what is already pinned, otherwise an account would be registered on one email and confirmed with another. The agent never sees the values themselves (see Security).

Example prompts that work out of the box:

Create twenty profiles with the prefix shop, give them proxies from this

list, and launch the first five.

Check the proxies on every profile I can manage and tell me which ones are

dead or exiting from the wrong country.

Take the mail-batch set, spread it across the open windows and show me who

got what. I'll put the cursor in the email field, then insert.

Requirements

instead of failing silently

• Windows 10 or 11
• Morfiade 3.36 or newer, running
• Local API enabled in its settings — the server refuses to start without it

default, and unticked profiles do not exist as far as the agent is concerned

• The "API" checkbox ticked on the profiles the agent may touch; it is off by

Gemini CLI, VS Code, your own

• A valid licence to launch profiles (that check lives in the manager, not here)
• Any MCP client with stdio support: Claude Code, Claude Desktop, Cursor,

No pip install, no Node, no API key to register.

Setup

Point your client at the executable and pass --mcp:

{
  "mcpServers": {
    "morfiade": {
      "command": "C:\\Program Files\\Morfiade\\Morfiade.exe",
      "args": ["--mcp"]
    }
  }
}

Ready-made files for the common clients are in examples/. Claude Code can do it in one line:

claude mcp add morfiade -- "C:\Program Files\Morfiade\Morfiade.exe" --mcp

Where the config file lives differs per client and changes more often than this README — check your client's own docs.

Optional launcher

If you would rather not hardcode the path, morfiademcp.py finds the executable (via MORFIADEEXE, the installer's registry key, the usual install directories, or PATH), forwards stdio and returns its exit code. Requires Python 3.7+ and nothing else.

pip install morfiade-mcp

{
  "mcpServers": {
    "morfiade": {
      "command": "morfiade-mcp"
    }
  }
}

If your client needs an absolute path, point it at the morfiade-mcp.exe that pip put in your Python Scripts directory. Without the package, the single file works on its own too — "command": "python" with morfiade_mcp.py as the only argument.

The package contains only that launcher. The server, and everything it talks to, is the desktop app.

Tools

Full parameters and return shapes: docs/TOOLS.md.

Shortened. The full README is on GitHub.