Claude Flow MCP Server

An agent meta-harness for Claude Code and Codex. One npx ruflo init gives Claude Code a nervous system: agents self-organize into swarms, learn from every task, remember across sessions, and - with federation - securely talk to agents on other machines without leaking data. You keep writing code. Ruflo handles the coordination.

People connecting automation tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-24 · ★ 69,309 · #2 OF 194 MAINTAINED AUTOMATION · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Claude Flow

before you install - you'll need

The README does not document required environment variables for a basic install.

Claude Code

claude mcp add ruvnet-claude-flow -- npx -y claude-flow

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "ruvnet-claude-flow": {
      "command": "npx",
      "args": [
        "-y",
        "claude-flow"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package claude-flow - unscoped; check the name against the project README before installing

registry namespace io.github.ruvnet is GitHub-verified and matches the repo owner

03 · What Claude Flow can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v3.38.20 · 2026-08-24

Fix · stop pinning intelligence to a hardcoded 0% (#3092, closes #3091) · intelligencePct had exactly one assignment in the whole statusline helper, inside the local-CLI fallback path. Every other read used it as-is…

v3.38.19 · 2026-08-22

Supersedes v3.38.17 and v3.38.18, both of which shipped with a corrupted dependency graph due to a publish race between two concurrent sessions working this checkout simultaneously (see the postmortem note below).…

v3.38.18 · 2026-08-22

--- · BROKEN - superseded by v3.38.19 · This version (and 3.38.17) shipped with a corrupted dependency graph due to a publish race - see v3.38.19 for the postmortem. @claude-flow/cli, claude-flow, and ruflo are all…

04 · Who maintains Claude Flow

claude-flow is maintained by ruvnet. We track 3 MCP servers from ruvnet - 3 actively maintained, 69,787 combined GitHub stars, oldest repo from Jun 2025. Full record: all servers from ruvnet.

  1. ruv-swarm Neural network swarm orchestration with WebAssembly acceleration and MCP integration ★ 378
  2. flow-nexus Cloud-powered AI platform with multi-agent swarms, sandboxes, and workflow automation ★ 100

05 · Facts

category
automation - ranked #2 of 194 actively-maintained automation servers as of 2026-08-25.
release cadence
10+ releases in the last 90 days (latest 2026-08-24)
registry
io.github.ruvnet/claude-flow (active, first published 2025-09-10 · 4 versions)
packages
npm:claude-flow

06 · Claude Flow FAQ

What is Claude Flow?

An agent meta-harness for Claude Code and Codex. One npx ruflo init gives Claude Code a nervous system: agents self-organize into swarms, learn from every task, remember across sessions, and - with federation - securely talk to agents on other machines without leaking data. You keep writing code. Ruflo handles the coordination.

Is Claude Flow still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-24 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

How do I install Claude Flow?

Run `npx -y claude-flow`. The README does not document required environment variables for a basic install. You can also paste the ready-made client config above.

Does Claude Flow run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Claude Flow

head to head · Ha MCP vs Claude Flow · Tooluniverse vs Claude Flow · Windows MCP vs Claude Flow