Install Mistflow

Mistflow works with any AI editor that supports MCP — Claude Code, Cursor, Codex CLI, and more.

One-line install

Installs Node.js if needed, then configures your editors.

macOS / Linux

curl -fsSL https://mistflow.ai/install.sh | sh

Inspect first: curl https://mistflow.ai/install.sh

Windows

irm https://mistflow.ai/install.ps1 | iex

With npx (if you already have Node 20+)

1. Run the installer

   npx -y mistflow-ai install

   The installer auto-detects your editors and configures them.

2. Log in

   Open your AI editor and say:

   Log me in to Mistflow

   Your browser opens to app.mistflow.ai. Sign in (or create an account), and your credentials are stored locally in ~/.mistflow/credentials.json.

3. Verify

   Ask your editor:

   What can Mistflow do?

   If your editor lists Mistflow’s capabilities, you’re all set.

Manual install

Caution

The one-line install above is the recommended path — it pre-approves Mistflow’s tools so you’re not prompted on every call. The manual configs below register the MCP server but skip the permission seeding, so you’ll see a permission dialog the first time each tool runs. Click “Always allow” once and it’ll stick.

Claude Code

Edit ~/.claude.json:

{
  "mcpServers": {
    "mistflow": {
      "command": "npx",
      "args": ["-y", "@mistflow-ai/mcp"]
    }
  }
}

Restart Claude Code, then say “Log me in to Mistflow” to authenticate.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "mistflow": {
      "command": "npx",
      "args": ["-y", "@mistflow-ai/mcp"],
      "transport": "stdio"
    }
  }
}

Fully quit Claude Desktop (⌘Q on Mac), reopen it, then switch to the Code tab — Mistflow tools live there, not in the regular chat.

Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "mistflow": {
      "command": "npx",
      "args": ["-y", "@mistflow-ai/mcp"]
    }
  }
}

Restart Cursor, then say “Log me in to Mistflow” to authenticate.

Codex

Edit ~/.codex/config.toml:

[mcp_servers.mistflow]
command = "npx"
args = ["-y", "@mistflow-ai/mcp"]

Restart Codex, then say “Log me in to Mistflow” to authenticate.

VS Code Copilot

Edit .vscode/mcp.json in your project:

{
  "servers": {
    "mistflow": {
      "command": "npx",
      "args": ["-y", "@mistflow-ai/mcp"],
      "type": "stdio"
    }
  }
}

Reload VS Code, then say “Log me in to Mistflow” in Copilot chat to authenticate.

Tip

No API keys needed in config. Mistflow uses a device code flow — you log in through your browser and credentials are stored securely in ~/.mistflow/credentials.json.

Updating

npx -y mistflow-ai install

Running the installer again always pulls the latest version.

Troubleshooting

Problem	Solution
Editor doesn’t see Mistflow	Restart your editor. Check that the MCP config has the mistflow entry.
”Authentication failed”	Say “Log me in to Mistflow” in your editor to re-authenticate.
”Command not found: npx”	Install Node.js 20+ from nodejs.org.

For more help, see Troubleshooting.