Skip to main content
KiwiFS ships a built-in MCP server so agents can work with the same operations as the REST API and web UI.

​
Start the MCP server

# In-process (reads files directly, no HTTP server required)
kiwifs mcp --root ~/knowledge

# Proxy mode (forwards to a running KiwiFS server)
kiwifs mcp --remote http://host:3333 --api-key kiwi_sk_...

# Streamable HTTP transport (remote agents, LAN tools)
kiwifs mcp --root ~/knowledge --http --port 8181
Use --space <name> when the knowledge root hosts multiple configured spaces. Remote HTTP MCP should stay behind TLS and reuse the same API keys you trust for REST.

​
Configure Claude Desktop / Cursor

{
  "mcpServers": {
    "kiwifs": {
      "command": "kiwifs",
      "args": ["mcp", "--root", "/path/to/knowledge"]
    }
  }
}

​
Tool inventory

The server currently registers 60+ tools (exact count may change release to release). They are grouped below; every name is invoked as listed.
ToolSummary
kiwi_query_metaFrontmatter filters with AND/OR groups, sort, pagination.
kiwi_queryDQL queries (TABLE, LIST, COUNT, DISTINCT, …).
kiwi_aggregateGROUP BY style aggregates over metadata.
kiwi_importPull from databases, CSV/JSON, Notion, Airtable, etc.
kiwi_exportExport JSONL/CSV with optional embeddings.
kiwi_analyticsKnowledge-base health metrics.
kiwi_health_checkSingle-page diagnostics.
kiwi_memory_reportEpisodic memory coverage / merge hints.
kiwi_velocityChange hotspots, cold pages, bursts.
kiwi_evalSearch quality benchmark harness.
kiwi_contextSchema, playbook, index, and rules in one call — good first tool.
kiwi_backlinksIncoming wiki links for a page.
kiwi_suggestionsSemantically similar pages excluding existing links.
kiwi_embeddingsRaw chunk embeddings for a page.
kiwi_graph_analyticsPageRank-ish graph summary.
kiwi_graph_centralityPageRank and betweenness tables.
kiwi_graph_communitiesLouvain communities.
kiwi_graph_pathShortest path between two pages.
kiwi_graph_walkLocal neighborhood / siblings around a page.
kiwi_eligibleRanked todo-style tasks inferred via metadata heuristics.
ToolSummary
kiwi_draft_createOpen a new git-backed draft branch.
kiwi_draft_listList active drafts.
kiwi_draft_read / kiwi_draft_writeWork inside a draft by draft_id.
kiwi_draft_diffUnified diff vs main.
kiwi_draft_mergeMerge draft into live knowledge.
kiwi_draft_discardDrop the draft branch.
ToolSummary
kiwi_views_listList .kiwi/views/*.json definitions.
kiwi_views_getFetch a single view definition.
kiwi_views_savePersist columns, filters, sort, layout, and query.
kiwi_views_deleteRemove a saved view.
kiwi_views_executeRun the DQL backing a view and return rows.
ToolSummary
kiwi_canvas_listDiscover *.canvas.json files.
kiwi_canvas_read / kiwi_canvas_writeJSON canvas payloads.
Canvas generate, patch, query, and auto-layout are REST-only — see Canvas API.
ToolSummary
kiwi_workflow_list / kiwi_workflow_get / kiwi_workflow_saveManage .kiwi/workflows/*.json.
kiwi_workflow_advanceValidate and apply a frontmatter state transition.
kiwi_workflow_boardKanban-style board grouped by state.
kiwi_claim / kiwi_releaseCooperative leases on paths (requires actor headers in practice).
kiwi_claims_listInspect active claims.
ToolSummary
kiwi_peekLightweight summary (title, snippet, links, headings).
kiwi_sectionExtract a single heading section by name or index.
kiwi_timelineRecent git-backed activity with pagination metadata.
kiwi_feedSerialized activity feed (JSON or Atom depending on mode).
kiwi_clipFetch a URL and persist clipped markdown.
kiwi_ingestConvert supported binary documents to markdown via MarkItDown.
kiwi_export_documentRender markdown to PDF, HTML, slides, or a static site.
kiwi_lintStructural markdown lint for a path or inline content.
kiwi_evalBenchmark full-text and semantic search quality.

​
Resources

Read-only MCP resources:
URI patternDescription
kiwi://schemaSCHEMA.md (or generated schema) for the knowledge root.
kiwi://file/{path}Markdown bytes for a relative path.
kiwi://tree/{path}Directory listing rooted at {path}.

​
Further reading

Last modified on May 23, 2026