English Français العربية

io.github.Harflow-Dev/harflow-mcp

Official registry Developer tools

Dispatch coding tasks to local headless agents with persistent history and workflows.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package harflow-mcp
Claude Code 
claude mcp add harflow-mcp -- uvx harflow-mcp==0.0.5
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "harflow-mcp": {
            "command": "uvx",
            "args": [
                "harflow-mcp==0.0.5"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

HarflowMCP

HarflowMCP is a local MCP server that dispatches coding tasks to Claude Code, Codex, opencode, Vibe, and Antigravity. It provides persistent task history, bounded reads, cancellation, continuation, and reusable workflows. On measured Claude Code versions, callers can opt in to approving individual Bash, Read, Write and Edit requests one exact action at a time (see harness permissions), and can grant a task a bounded list of specific Bash commands with allowed_commands instead of unrestricted access (see dispatch-time command grants).

Current limits of these two features: they are qualified only on Claude Code 2.1.302 (Bash approvals) and 2.1.310; other backends refuse them. Approvals are not available to native workflow children, and a request unanswered after 1800 seconds (or at the node's attempt deadline) is rejected by Harflow, never approved. After a denial there is no approve-later path: recovery is always a new resume_task or continue_task execution guided by denial_remedy (allowed_commands covers only Bash approval_required and chained-command parts; a denied Read, Write or Edit needs a resumed run so the agent can raise a fresh request; a deny_rule cannot be lifted by grants). Retrying a permission-blocked workflow node with a narrow grant, approval notifications and Monitor presentation of approvals are not available yet. See harness permissions.

Vibe runs use its Python CLI entrypoint for headless dispatch; interactive takeover continues with the user's inherited environment.

Version 0.0.2 is under development and unreleased. Harflow, the companion macOS application, is maintained separately and prepares its own exact paired engine runtime. Its managed runtime and MCP registrations work independently of the app process; see the managed runtime guide.

Detached task owners preserve output capture and live input across MCP server restarts. Workflow scheduler recovery is explicit; see supervision and recovery. Recovered tasks disclose owner/process uncertainty and capture continuity. Qualified Claude transcripts can supply bounded display-only recovery activity; see public contracts. Live background wait bounds are persisted and configurable; see task continuation.

Use harflow-ctl version-info --json to inspect runtime identity and compatibility without initializing state. Engine operations require compatible Harflow state, task metadata, saved workflow definitions, workflow run documents and workflow ownership receipts. Known qualified storage lines migrate conservatively before new-line writes. Use harflow-ctl state-inspect --json to inspect an incompatible root without changing it, then explicitly confirm its state-recover proposal to retain a sibling backup and create fresh state. HARFLOW_STATE_ROOT can also select a separate fresh state directory; see state ownership and recovery for compatibility requirements.

See the Changelog for change history.

Licensed under Apache-2.0. Git history preserves source authorship; the license notice does not assert ownership of prior contributions.

Frequently asked questions

What is io.github.Harflow-Dev/harflow-mcp?

Dispatch coding tasks to local headless agents with persistent history and workflows.

How do I install io.github.Harflow-Dev/harflow-mcp?

It runs on your machine. In Claude Code: claude mcp add harflow-mcp -- uvx harflow-mcp==0.0.5. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Harflow-Dev/harflow-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.Harflow-Dev/harflow-mcp open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Who maintains io.github.Harflow-Dev/harflow-mcp?

It is published by Harflow-Dev. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.