Granoflow MCP server

Granoflow MCP Server

Granoflow is a local-first app for planning work, reviewing completed tasks, and turning durable lessons into review cards. Granoflow MCP connects MCP-capable AI agents to a local task, review, and long-term work memory layer.

Granoflow's local features are free to use forever. If privacy is your concern, do not subscribe: without membership, your data never leaves your device or gets uploaded to the cloud.

Learn more at granoflow.com.

MCP server for Granoflow: exposes the Granoflow Local HTTP API as tools for AI agents and IDEs that need to track task work, finish tasks with meaningful reviews, and preserve reusable lessons as memory cards.

This is not a code analyzer, CI fixer, or repository automation framework. If your only goal is to make an AI coding agent write better code, use tests, linters, CI, prompts, and code-analysis tools directly. Granoflow MCP is for the surrounding agent workflow: what task the agent is doing, what happened, what should be remembered, and what deserves review later.

Granoflow MCP can support any agent-assisted work, but it is especially useful for software projects. If you are not a programmer, or if you have not used AI coding agents before, Granoflow helps you benefit from the experience AI builds while it works. You can read, understand, and learn from those records so AI work is no longer a black box, or ignore them and let future agents search the same durable experience tomorrow, next month, or next year. That way your agent can continue past work instead of inventing a fresh plan every time and fragmenting the project into disconnected attempts, without replacing tests, linters, or engineering judgment.

This server is intentionally thin. It does not own Granoflow business logic, database access, app orchestration, or release workflows. It resolves a local API endpoint, forwards structured requests to the running Granoflow app, and returns predictable MCP tool results.

Granoflow App owns task and work-memory truth. Granoflow MCP is the control-plane protocol surface. The host Agent/runtime owns traversal, Skill/provider routing, and execution handoff; repository, browser, image, video, and other tools perform the actual work. A user instruction to implement the active Task Work Document authorizes the host, not the MCP server, to enter the execution plane.

External Skill routing is host-owned and capability-based. For a relevant Skill, the host may call it only when current metadata permits model invocation; user-only Skills are suggested for explicit user invocation. When a Skill is missing, the host shows a verified source, actual installation scope, and verified command before asking for installation approval, then waits without assuming refusal. Refusal, installation, rediscovery, reload, or invocation failure uses a documented model capability fallback. Granoflow MCP does not scan or modify the host's global Skill environment and does not treat Skill invocation as authorization to implement, commit, publish, or perform another gated action.

Requirements

• Node.js 20 or newer.
• A running Granoflow app with the Local HTTP API enabled.

The default Granoflow API URL is:

http://127.0.0.1:56789

You can override it with:

export GRANOFLOW_API_BASE_URL="http://127.0.0.1:56789"
export GRANOFLOW_API_TOKEN="..."

The MCP server can keep non-secret local connection defaults in:

~/.config/granoflow-mcp/config.json

Set GRANOFLOWMCPCONFIGPATH to use a different config path for tests, temporary setups, or advanced local installs. API tokens are not stored in this file; keep GRANOFLOWAPI_TOKEN in the MCP client environment.

Shortened. The full README is on GitHub.