Log inSubmit server
Scriptflow MCP logo

Scriptflow MCP

by yanmxa

Manage, search, edit, and run reusable Bash, Python, JavaScript, and TypeScript scripts through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Scriptflow MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "yanmxa-scriptflow-mcp": {
      "command": "npx",
      "args": [
        "scriptflow-mcp"
      ],
      "env": {
        "SCRIPTFLOW_SCRIPTS_DIR": "YOUR_VALUE_HERE",
        "SCRIPTFLOW_TIMEOUT": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

yanmxa/scriptflow-mcp MCP server stores reusable scripts in a local repository and exposes tools for adding, finding, inspecting, editing, running, and removing them. Scripts can be written in Bash, Python, JavaScript, or TypeScript, with execution arguments supported by the run tool. Use it when recurring workflows are better represented as persistent scripts than repeated AI conversations. Configuration supports a custom scripts directory and an execution timeout.

Use cases

  • Save recurring AI-assisted workflows as executable scripts
  • Search a local library of scripts by name, description, or tags
  • Run Bash, Python, JavaScript, or TypeScript tasks with arguments
  • Edit and reuse scripts across MCP sessions

Key features

  • Script creation and metadata management
  • Search and filtering by name, description, or tags
  • Execution with arguments
  • Bash, Python, JavaScript, and TypeScript support
  • Configurable script directory and timeout
  • File-based script and JSON metadata storage

Tools6

What Scriptflow MCP lets your agent do. Expand a tool for its parameters.

Verified live~548 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

17/18 checks healthy over the last 80d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 3d ago via OSV.dev · scriptflow-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars8Stargazers on the source repository.
npm downloads35Package downloads in the last 30 days.
Last commit1y agoMost recent push to the default branch.
Tools exposed6Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Scriptflow MCP works

What yanmxa/scriptflow-mcp MCP server does

yanmxa/scriptflow-mcp MCP server provides an MCP interface for managing a local collection of executable scripts. It is designed for workflows that recur across sessions and can be captured as named scripts rather than reconstructed through repeated interactions.

Each script has content, a language, a name, a description, and optional tags. The available operations cover the script lifecycle: create a script, inspect its details, search or list scripts, modify an existing script, execute one by name, and remove it. Scripts can be written in Bash, Python, JavaScript, or TypeScript.

The repository stores script content and metadata as files. A script uses a filename based on its name and language extension, while its metadata is kept in a matching JSON file. This file-based layout can also be placed under version control, although the provided tools do not expose separate version-control operations.

How it works

An MCP client starts the server, commonly through npx scriptflow-mcp. The client can then call the exposed tools to maintain the script repository. script_add accepts the script name, description, content, language, and tags. script_list supports discovery and filtering, including searches by name, description, or tags.

To inspect one entry, call script_get with the script name. script_edit updates an existing script, and script_rm deletes one. script_run executes a named script and can receive arguments. Execution is subject to the configured timeout.

This model fits repeatable tasks where keeping an exact script is preferable to asking an AI model to reproduce the same multi-step interaction each time. It does not turn an interaction into an autonomous workflow by itself; the workflow must be represented by script content that the supported runtime can execute.

Setup and configuration

Configure yanmxa/scriptflow-mcp MCP server as an MCP process in the client configuration. A typical entry uses the npx command with scriptflow-mcp as its argument.

SCRIPTFLOW_SCRIPTS_DIR selects the repository location. If it is not set, the default is /tmp/scriptflow-mcp/scripts. SCRIPTFLOW_TIMEOUT sets the execution timeout in milliseconds, with a default of 30000.

After installation, the repository can be tested with the MCP Inspector using npx @modelcontextprotocol/inspector npx scriptflow-mcp. The project also documents an npm test command for its test suite.

Tools and capabilities

  • Add scripts with metadata using script_add.
  • Find scripts using script_list, including name, description, or tag searches.
  • Read stored details with script_get.
  • Change existing scripts with script_edit.
  • Run scripts by name and pass arguments with script_run.
  • Delete scripts with script_rm.
  • Store and execute Bash, Python, JavaScript, and TypeScript files.

Limitations and notes

yanmxa/scriptflow-mcp MCP server executes local script files, so the selected scripts directory and runtime environment determine what can run successfully. The material specifies a configurable timeout but does not describe sandboxing, permission controls, remote storage, or dependency management.

The server manages scripts and their metadata through MCP tools; it does not document tools for directly editing conversation history or generating scripts automatically from prior AI interactions. Any reusable workflow must be added as script content before it can be run.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Scriptflow MCP

yanmxa/scriptflow-mcp is an MCP server that connects an MCP client to a local repository of reusable scripts. Its main tools add, list, get, edit, run, and remove scripts. It supports Bash, Python, JavaScript, and TypeScript files, with script metadata, search, execution arguments, and configurable storage and timeout settings.

Install it by adding an MCP client entry that runs `npx` with `scriptflow-mcp` as the argument. You can optionally set `SCRIPTFLOW_SCRIPTS_DIR` and `SCRIPTFLOW_TIMEOUT` in the entry's environment.

Scripts are stored in the directory configured by `SCRIPTFLOW_SCRIPTS_DIR`. If that variable is unset, the default location is `/tmp/scriptflow-mcp/scripts`. Each script is stored with its language extension alongside a matching JSON metadata file.

yanmxa/scriptflow-mcp supports Bash, Python, JavaScript, and TypeScript. The language is supplied when a script is added, and the server stores the script using the corresponding file extension before execution.

Yes, it can be used with Cursor as a standard MCP server, provided Cursor is configured to launch the server process. The supplied setup example uses Claude Desktop, but the server runs through the normal `npx scriptflow-mcp` command.

Related MCP servers

All in Code Execution All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewScriptflow MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/yanmxa-scriptflow-mcp?style=directory)](https://allmcps.com/mcp/yanmxa-scriptflow-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/yanmxa-scriptflow-mcp"><img src="https://allmcps.com/api/badge/yanmxa-scriptflow-mcp?style=directory" alt="Scriptflow MCP on AllMCPs" /></a>