mcpbeat Sign in

Workflows MCP Server

local only

Workflows MCP Server runs on your own machine — the client starts it, so there is no endpoint to ping. 288 installs a week from npm. Last commit 13 Sep 2026.

Store, query, and create YAML workflow playbooks for LLM agents.

Installs per day peak 191 · avg 34 · +39% w/w
a month agotoday
288
Installs / week
npm · @cyanheads/workflows-mcp-server
31
Stars
12 open issues
13 Sep 2026
Last commit
0 releases in 90 days
Apache-2.0
License
TypeScript

What the code does

We read the source, 23 h ago · rules 3dff92dd89df

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

    const categoryDir = path.join(this.workflowsDir, 'categories', categorySlug);

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add workflows-mcp-server -- npx -y @cyanheads/workflows-mcp-server
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "workflows-mcp-server": {
      "args": [
        "-y",
        "@cyanheads/workflows-mcp-server"
      ],
      "command": "npx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.workflows-mcp-server]
command = "npx"
args = ["-y", "@cyanheads/workflows-mcp-server"]
.cursor/mcp.json
{
  "mcpServers": {
    "workflows-mcp-server": {
      "args": [
        "-y",
        "@cyanheads/workflows-mcp-server"
      ],
      "command": "npx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "workflows-mcp-server": {
      "args": [
        "-y",
        "@cyanheads/workflows-mcp-server"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: WORKFLOWS_DIR (Absolute or relative path to the workflows root directory.), GLOBAL_INSTRUCTIONS_PATH (Path to the global instructions markdown file. Derives from WORKFLOWS_DIR when not set.), WATCHER_DEBOUNCE_MS (Milliseconds to debounce filesystem change events before rebuilding the index.), MCP_HTTP_HOST (The hostname for the HTTP server.), MCP_HTTP_PORT (The port to run the HTTP server on.), MCP_HTTP_ENDPOINT_PATH (The endpoint path for the MCP server.), MCP_AUTH_MODE (Authentication mode to use: 'none', 'jwt', or 'oauth'.), MCP_LOG_LEVEL (Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').). The author declared them in the registry entry; get the values from the project itself.

Alternatives to Workflows MCP Server

same job, measured the same way
Orbit
by constellation-works

Orbit's local-first task and workflow registry for coding agents.

624 installs/wk local only
Snapstate
by timbassler88

Persistent state for AI agent workflows. Save, resume, and replay multi-step workflows.

28 installs/wk local only
n8n Manager MCP
by lukisch

MCP server for n8n workflow management -- view, create, sync and manage workflows via AI.

109 installs/wk local only
n8n Manager MCP
by ellmos-ai

MCP server for n8n workflow management -- view, create, sync and manage workflows via AI.

local only
BugBug
by bugbug-io

BugBug workflows for AI agents workflows for AI agents

answering
Rippr MCP
by mrslbt

Rip YouTube transcripts to disk for AI agents, RAG pipelines, and LLM workflows.

42 installs/wk local only
Koda
by aabxtract

Verification and memory layer for coding-agent workflows.

48 installs/wk local only
Ipfs Toolkit
by tkllabs-bh-mcp-servers

Store, retrieve, and pin encrypted files on IPFS via MCP tools for AI agents and workflows

answering

Workflows MCP Server — questions

Answers built from our own checks of this server.

Why is there no uptime for Workflows MCP Server?
Workflows MCP Server runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package @cyanheads/workflows-mcp-server was installed 288 times last week.
How do I connect Workflows MCP Server?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls @cyanheads/workflows-mcp-server straight from npm; nothing to host, nothing to sign up for.
How many people use Workflows MCP Server?
The npm package @cyanheads/workflows-mcp-server was installed 288 times in the last week. Week over week that is +39%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Workflows MCP Server open source?
Yes — it is published under the Apache-2.0 licence, written in TypeScript, 31 stars on GitHub and 12 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.