Workflows MCP Server - install, status & alternatives [2026]

01 · Install Workflows MCP Server

before you install - you'll need

Set MCP_TRANSPORT_TYPE, WORKFLOWS_DIR before connecting.

Claude Code

claude mcp add cyanheads-workflows-mcp-server -- npx -y @cyanheads/workflows-mcp-server

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "cyanheads-workflows-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/workflows-mcp-server"
      ]
    }
  }
}

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 Apache-2.0 - declared in the repository

npm package @cyanheads/workflows-mcp-server - published under the repo owner's npm scope (@cyanheads)

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

03 · What Workflows MCP Server can do

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

What you can build

With this server connected, an agent can list all permanent workflows in the index, with optional keyword, category, and tag filters, retrieve a complete workflow definition by name, with global instructions prepended, write a new permanent workflow YAML to the library, and write a temporary one-shot workflow, indexed but excluded from list results.

Capability map

Tools grouped from the project's README - what Workflows MCP Server lets an agent do.

Workflow

5 tools - e.g. List all permanent workflows in the index, with optional keyword, category, and tag filters.; Retrieve a complete workflow definition by name, with global instructions prepended.; Write a new permanent…

workflow_list · workflow_get · workflow_create · workflow_create_temp · workflow_delete

Semver

1 tool - e.g. omit version to get the highest available match; specify a version for an exact lookup

Semver-aware

Irreversible

1 tool - e.g. the file is removed and the workflow no longer appears in workflow_list or workflow_get

Irreversible

Latest releases

v0.3.0 · 2026-08-21

MCP SDK v2 maintenance · MCP SDK v2 serves the 2026-07-28 protocol alongside 2025-era clients, rejects unknown root tool inputs, and advertises the structured error envelope. · TypeScript 7, Bun 1.4, supply-chain…

v0.2.0 · 2026-07-01

workflow_delete tool and workflow_list query filter · Completes library CRUD with a delete tool and adds keyword search to workflow_list, alongside a client-facing definition-language pass. · Added: · workflow_delete…

v0.1.4 · 2026-07-01

first-run workflow root + seed category fixes · Two hygiene fixes for a clean first boot. · Fixed: · Missing WORKFLOWS_DIR on first run: WorkflowIndexService.init() now creates the workflow root before rebuild/watch…

04 · Who maintains Workflows MCP Server

workflows-mcp-server is maintained by cyanheads. We track 125 MCP servers from cyanheads - 124 actively maintained, 1,730 combined GitHub stars, oldest repo from Dec 2024. Full record: all servers from cyanheads.

05 · Facts

repository: github.com/cyanheads/workflows-mcp-server
category: automation - ranked #58 of 194 actively-maintained automation servers as of 2026-08-25.
release cadence: 6 releases in the last 90 days (latest 2026-08-21)
registry: io.github.cyanheads/workflows-mcp-server (active, first published 2026-05-28 · 6 versions)
packages: npm:@cyanheads/workflows-mcp-server · npm:@cyanheads/workflows-mcp-server

06 · Workflows MCP Server FAQ

Is Workflows MCP Server still maintained?

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

What can Workflows MCP Server do?

With this server connected, an agent can list all permanent workflows in the index, with optional keyword, category, and tag filters, retrieve a complete workflow definition by name, with global instructions prepended, write a new permanent workflow YAML to the library, and write a temporary one-shot workflow, indexed but excluded from list results.

How do I install Workflows MCP Server?

Run `npx -y @cyanheads/workflows-mcp-server`. The README documents 2 environment variables (MCP_TRANSPORT_TYPE, WORKFLOWS_DIR) to set first. Set MCP_TRANSPORT_TYPE, WORKFLOWS_DIR before connecting. You can also paste the ready-made client config above.

Does Workflows MCP Server 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 Workflows MCP Server

Alternatives to Workflows MCP Server

Maintained automation servers if Workflows MCP Server isn't the fit.

More automation MCP servers · Cypress Cloud MCP · Teamcity · Make MCP · Google Ads Intent MCP · Adeu

More TypeScript MCP servers · Worldbank MCP Server · LLM Advisor · Local RAG (damoqiongqiu) · Convalytics · see all