Name: Granoflow
Author: granoflow

LABSCO SUMMARY

Writes are previewed and confirmed, not fired.

Almost every mutation here comes in a pair — a preview that shows the candidate and the old and new values, then an apply you have to ask for — which is what makes handing an agent a personal work record tolerable. The payoff is on the read side: a task next month can find what was decided this month instead of starting the argument again.

What it is

A thin control plane over Granoflow, a local-first app for planning work, reviewing finished tasks and turning durable lessons into review cards. The server resolves the app's Local HTTP API and forwards structured requests to it; the app owns the data. It is not a code analyser or a CI fixer — it is the layer that records what task an agent is on, what happened, and what should be remembered.

What you get

Tasks created from a requirement as it is discussed, listed, updated, completed, exported, validated and re-imported, with attachments and structured work nodes underneath them
Projects and milestones created and resolved, with their descriptions kept as a living context map — the active milestone as the current phase, archived ones as final snapshots
Completion records and review cards written at the end of a task, so the lesson survives the session it was learned in
Durable experience as its own layer: experiences listed, searched, merged, linked to the work that used them, and unlinked with the impact shown first
Knowledge assessed and materialised through a preview-then-apply pair at every step, with a per-task knowledge pack, its references, and an audit of what was actually adopted
Evidence stored, searched and edited alongside it, so a claim in a review points at something
A context pack for the current work and candidates from historical tasks, which is what lets a later agent continue rather than restart
Bundled workflow skills read straight from the package — daily review, first-run import, task authoring, milestone coordination, portfolio orchestration and more — each returning its own SKILL.md plus a reference manifest, read-only, with no API token needed
Setup that diagnoses itself: connection status, local API detection, a config write previewed before it happens, and an explicit report when an environment variable is shadowing the saved value instead of pretending it is active
An escape hatch to the Local HTTP API for anything the typed tools do not cover

Requirements

Node.js 20 or newer and the Granoflow desktop app running with its Local HTTP API enabled — this talks to your machine, not to a hosted service. The API defaults to http://127.0.0.1:56789, overridable with GRANOFLOW_API_BASE_URL, and the token comes from the client environment as GRANOFLOW_API_TOKEN. Non-secret connection defaults live in ~/.config/granoflow-mcp/config.json, with GRANOFLOW_MCP_CONFIG_PATH pointing elsewhere; tokens are never written there. Granoflow's local features are free, and without a membership the data stays on the device.

Setup effort

One command — npm install -g @granoflow/mcp-server

See installation options

USE CASES

Turning something you just discussed into a task

Capture the requirement as a task in the right project or milestone, filled out rather than titled and forgotten.

granoflow_task_create_structuredgranoflow_project_resolvegranoflow_milestone_resolve

Working today's queue

List what is due, pull the context pack and any similar historical tasks, and work through them with the record filling in as you go.

granoflow_task_listgranoflow_context_packgranoflow_historical_task_candidates

Finishing a task so the lesson survives it

Close it with a completion record and write the durable point as a review card rather than leaving it in the transcript.

granoflow_task_completegranoflow_task_completion_recordgranoflow_review_card_record

Answering what did we decide last time

Search the stored experience and the evidence behind it, scoped to the project or the milestone it came from.

granoflow_experience_searchgranoflow_evidence_searchgranoflow_project_experiences

Giving the next agent what this one learned

Build the task's knowledge pack, preview which references it should adopt, and apply only what you approve.

granoflow_task_knowledge_packgranoflow_task_knowledge_adoption_previewgranoflow_task_knowledge_adoption_apply

Getting it connected the first time

Check the connection, detect the local API, and write the port into the config after reviewing the exact change.

granoflow_setup_statusgranoflow_setup_detect_local_apigranoflow_setup_write_configgranoflow_health

141 tools

Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.

`granoflow_acceptance_delivery_skill`

Read the bundled Granoflow Acceptance And Final Delivery skill. Route Layer A/B milestone acceptance (user-invisible milestone IT) and最终交付 paths: 1 feature milestone → e2e_direct full-project E2E; ≥2 → full unit + project IT + full-project E2E. Thin router over agent-workflow references and IT/E2E campaigns.

INSTALLATION

Connect your client

Server setup

TERMINAL

npm install -g @granoflow/mcp-server

MCP Clients

Cursor

CURSOR · JSON

{
  "mcpServers": {
    "granoflow": {
      "command": "npx",
      "args": [
        "-y",
        "@granoflow/mcp-server"
      ]
    }
  }
}

If you enabled an API token in Granoflow, add GRANOFLOW_API_TOKEN to this server's environment in your client — the project keeps the token there, not in its config file.

Codex

CODEX · TOML

[mcp_servers.granoflow]
command = "npx"
args = ["-y", "@granoflow/mcp-server"]

If you enabled an API token in Granoflow, add GRANOFLOW_API_TOKEN to this server's environment in your client — the project keeps the token there, not in its config file.

Any MCP client

ANY MCP CLIENT · JSON

{
  "mcpServers": {
    "granoflow-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@granoflow/mcp-server"
      ]
    }
  }
}

If you enabled an API token in Granoflow, add GRANOFLOW_API_TOKEN to this server's environment in your client — the project keeps the token there, not in its config file.

Granoflow

Writes are previewed and confirmed, not fired.

What it is

What you get

Requirements

Setup effort

Turning something you just discussed into a task

Working today's queue

Finishing a task so the lesson survives it

Answering what did we decide last time

Giving the next agent what this one learned

Getting it connected the first time

141 tools

granoflow_acceptance_delivery_skill

granoflow_agent_preferences_get

granoflow_agent_preferences_write_defaults

granoflow_agent_workflow_skill

granoflow_ai_agent_tools

granoflow_api_request

granoflow_bundled_skill_reference

granoflow_capabilities

granoflow_context_pack

granoflow_context_steward_status

granoflow_daily_review_skill

granoflow_delegated_authorization_skill

granoflow_e2e_test_campaign_skill

granoflow_evidence_authoring_apply

granoflow_evidence_authoring_preview

granoflow_evidence_delete

granoflow_evidence_get

granoflow_evidence_list

granoflow_evidence_search

granoflow_evidence_update

granoflow_experience_authoring_apply

granoflow_experience_authoring_preview

granoflow_experience_delete

granoflow_experience_delete_impact

granoflow_experience_get

granoflow_experience_list

granoflow_experience_merge_apply

granoflow_experience_merge_preview

granoflow_experience_search

granoflow_experience_update

granoflow_experience_usage_link

granoflow_experience_usage_unlink

granoflow_experience_usage_unlink_impact

granoflow_first_run_import_skill

granoflow_gfmcp_candidates

granoflow_gfmcp_prepare

granoflow_gfmcp_runner_skill

granoflow_gfmcp_safe_sync

granoflow_git_missing_notice_record

granoflow_health

granoflow_historical_task_candidates

granoflow_integration_test_campaign_skill

granoflow_knowledge_assessment_apply

granoflow_knowledge_assessment_get

granoflow_knowledge_assessment_list

granoflow_knowledge_assessment_preview

granoflow_knowledge_control_apply

granoflow_knowledge_control_preview

granoflow_knowledge_materialization_apply

granoflow_knowledge_materialization_get

granoflow_knowledge_materialization_list

granoflow_knowledge_materialization_preview

granoflow_logical_attachment_read

granoflow_logical_attachment_replace

granoflow_memory_batch_preview

granoflow_milestone_context_archive

granoflow_milestone_context_update

granoflow_milestone_coordination_skill

granoflow_milestone_create

granoflow_milestone_delete

granoflow_milestone_experiences

granoflow_milestone_knowledge_usages

granoflow_milestone_list

granoflow_milestone_resolve

granoflow_milestone_update

granoflow_milestone_workflow_skill

granoflow_persistent_milestone_runner_skill

`granoflow_acceptance_delivery_skill`

`granoflow_agent_preferences_get`

`granoflow_agent_preferences_write_defaults`

`granoflow_agent_workflow_skill`

`granoflow_ai_agent_tools`

`granoflow_api_request`

`granoflow_bundled_skill_reference`

`granoflow_capabilities`

`granoflow_context_pack`

`granoflow_context_steward_status`

`granoflow_daily_review_skill`

`granoflow_delegated_authorization_skill`

`granoflow_e2e_test_campaign_skill`

`granoflow_evidence_authoring_apply`

`granoflow_evidence_authoring_preview`

`granoflow_evidence_delete`

`granoflow_evidence_get`

`granoflow_evidence_list`

`granoflow_evidence_search`

`granoflow_evidence_update`

`granoflow_experience_authoring_apply`

`granoflow_experience_authoring_preview`

`granoflow_experience_delete`

`granoflow_experience_delete_impact`

`granoflow_experience_get`

`granoflow_experience_list`

`granoflow_experience_merge_apply`

`granoflow_experience_merge_preview`

`granoflow_experience_search`

`granoflow_experience_update`

`granoflow_experience_usage_link`

`granoflow_experience_usage_unlink`

`granoflow_experience_usage_unlink_impact`

`granoflow_first_run_import_skill`

`granoflow_gfmcp_candidates`

`granoflow_gfmcp_prepare`

`granoflow_gfmcp_runner_skill`

`granoflow_gfmcp_safe_sync`

`granoflow_git_missing_notice_record`

`granoflow_health`

`granoflow_historical_task_candidates`

`granoflow_integration_test_campaign_skill`

`granoflow_knowledge_assessment_apply`

`granoflow_knowledge_assessment_get`

`granoflow_knowledge_assessment_list`

`granoflow_knowledge_assessment_preview`

`granoflow_knowledge_control_apply`

`granoflow_knowledge_control_preview`

`granoflow_knowledge_materialization_apply`

`granoflow_knowledge_materialization_get`

`granoflow_knowledge_materialization_list`

`granoflow_knowledge_materialization_preview`

`granoflow_logical_attachment_read`

`granoflow_logical_attachment_replace`

`granoflow_memory_batch_preview`

`granoflow_milestone_context_archive`

`granoflow_milestone_context_update`

`granoflow_milestone_coordination_skill`

`granoflow_milestone_create`

`granoflow_milestone_delete`

`granoflow_milestone_experiences`

`granoflow_milestone_knowledge_usages`

`granoflow_milestone_list`

`granoflow_milestone_resolve`

`granoflow_milestone_update`

`granoflow_milestone_workflow_skill`

`granoflow_persistent_milestone_runner_skill`

`granoflow_portfolio_orchestrator_skill`

`granoflow_project_context_attachment_read`

`granoflow_project_context_attachment_reconcile`

`granoflow_project_context_attachment_write`

`granoflow_project_context_attachments_ensure`

`granoflow_project_context_update`

`granoflow_project_create`

`granoflow_project_definition_skill`

`granoflow_project_delete`

`granoflow_project_design_baseline_import`

`granoflow_project_design_baseline_read`

`granoflow_project_experiences`

`granoflow_project_interaction_style`