Workflows Mcp Server

Name: Workflows Mcp Server
Author: cyanheads

by cyanheadscommunityv0.1.1

An MCP server for storing, querying, and creating YAML workflow playbooks for LLM agents from a local workflows library. It supports listing permanent workflows, retrieving workflows with global instructions, and creating permanent or temporary workflows over STDIO or Streamable HTTP.

From the registry: Store, query, and create YAML workflow playbooks for LLM agents.

GitHub Repository

Install & configure

Prerequisites

optional
Install Node.js or Bun
Install Bun v1.3.2+ or Node.js v24+ so you can run the server. Prefer the npx path for portability, which requires Node.js and npm/npx.
https://bun.sh/
optional
Prepare a local workflows directory
Create or choose a local directory containing YAML workflow files, or use the repository's bundled workflows-yaml seed content. The server reads from a local workflows directory.

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `workflows-mcp-server` MCP server into my current AI client (that's you).

Optional prerequisites:
- Install Node.js or Bun — Install Bun v1.3.2+ or Node.js v24+ so you can run the server. Prefer the npx path for portability, which requires Node.js and npm/npx. (https://bun.sh/)
- Prepare a local workflows directory — Create or choose a local directory containing YAML workflow files, or use the repository's bundled workflows-yaml seed content. The server reads from a local workflows directory.

Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","@cyanheads/workflows-mcp-server@latest"]
- required environment variables:
  - `MCP_TRANSPORT_TYPE`: Transport to use for the MCP server. Set to stdio for client config usage. (example: `stdio`)
  - `WORKFLOWS_DIR`: Absolute or relative path to the workflows root directory containing your YAML workflow library. Although the README documents a default, in practical MCP client setup you should set this explicitly to the directory you want the server to read. (example: `<your-workflows-dir>`)
- optional environment variables:
  - `GLOBAL_INSTRUCTIONS_PATH`: Path to the global instructions markdown file. If omitted, it is derived from WORKFLOWS_DIR as <WORKFLOWS_DIR>/global_instructions.md. (example: `<your-global-instructions-path>`)
  - `WATCHER_DEBOUNCE_MS`: Milliseconds to debounce filesystem change events before rebuilding the workflow index. (example: `<your-watcher-debounce-ms>`)
  - `MCP_HTTP_PORT`: Port for HTTP mode. Not needed for stdio transport. (example: `<your-http-port>`)
  - `MCP_AUTH_MODE`: Authentication mode: none, jwt, or oauth. (example: `<your-auth-mode>`)
  - `MCP_LOG_LEVEL`: Log level in RFC 5424 format. (example: `<your-log-level>`)
  - `OTEL_ENABLED`: Enable OpenTelemetry instrumentation. (example: `<true-or-false>`)

Note: The README also supports Streamable HTTP. To run in HTTP mode, set MCP_TRANSPORT_TYPE=http and the server listens at <your-server-url>/mcp, with the example path shown as http://localhost:3010/mcp. However, no canonical MCP client HTTP config snippet with headers was provided, so stdio is the safest extracted config.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: The README also supports Streamable HTTP. To run in HTTP mode, set MCP_TRANSPORT_TYPE=http and the server listens at <your-server-url>/mcp, with the example path shown as http://localhost:3010/mcp. However, no canonical MCP client HTTP config snippet with headers was provided, so stdio is the safest extracted config.

Tools (4)

workflow_list

List all permanent workflows in the index, optionally filtered by category and tags.

workflow_get

Retrieve a complete workflow definition by name, optionally by version, including global instructions.

workflow_create

Write a new permanent workflow YAML to the library.

workflow_create_temp

Write a temporary one-shot workflow that is indexed but excluded from list results.

Environment variables

WORKFLOWS_DIRPath to the workflows root directory used as the local workflow library.

GLOBAL_INSTRUCTIONS_PATHPath to the global instructions markdown file prepended to workflow_get responses.

WATCHER_DEBOUNCE_MSDebounce interval for filesystem change events before rebuilding the index.

MCP_TRANSPORT_TYPETransport type for the server, either stdio or http.

MCP_HTTP_PORTPort used when running the HTTP server.

MCP_AUTH_MODEAuthentication mode for the server.

MCP_LOG_LEVELLogging level for the server.

OTEL_ENABLEDEnables OpenTelemetry instrumentation.

Prerequisites

• Node.js v24+

Packages

@cyanheads/workflows-mcp-server

npmv0.1.1transport: stdio

@cyanheads/workflows-mcp-server

npmv0.1.1transport: streamable-http

Details

Language: TypeScript
License: Apache-2.0
Released: May 28, 2026
Last commit: May 28, 2026
Registry name: io.github.cyanheads/workflows-mcp-server

Related Servers

Netdata

Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.

79.1k

Labelhead Artist Momentum

Trending hip-hop artist momentum scores across four cultural dimensions.

70.1k

Scrapling

Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.

63.1k