MindOS MCP Server

<h1 align="center">MindOS</h1>

<strong>Human Thinks Here, Agent Acts There.</strong>

English | 中文

MindOS is a Human-AI Collaborative Mind System—a local-first knowledge base that ensures your notes, workflows, and personal context are both human-readable and directly executable by Agents. One shared memory layer for all Agents — auditable, correctable, and smarter with every use.

---

<source media="(prefers-color-scheme: dark)" srcset="assets/images/demo-flow-dark.png" />
<source media="(prefers-color-scheme: light)" srcset="assets/images/demo-flow-light.png" />

[!IMPORTANT] ⭐ One-click install: Send this to your Agent (Claude Code, Cursor, etc.) to set up everything automatically:

Help me install MindOS from https://github.com/GeminiLight/MindOS with MCP and Skills. Use English template.

✨ Try it now: After installation, give these a try:

Read my MindOS knowledge base, see what's inside, then help me write my self-introduction into Profile.

Help me distill the experience from this conversation into MindOS as a reusable SOP.

Help me execute the XXX SOP from MindOS.

🧠 Human-AI Shared Mind

No more fragmented memory, no more black-box behavior, no more lost experience.

1. Global Sync — Breaking Memory Silos

Each Agent keeps its own memory — switching tools means manually hauling context. MindOS lets all Agents share one knowledge base via MCP and Skills — record once, reuse everywhere.

2. Transparent & Controllable — No More Black Boxes

What did your Agent remember? Is it even correct? You have no way to know. MindOS saves every read/write as local plain text — humans can audit, correct, and delete in the GUI.

3. Symbiotic Evolution — Experience Flows Back as Instructions

All that experience from your conversations — gone the moment you close the window. MindOS auto-distills conversation experience into Skills/SOPs. Notes are instructions. The knowledge base gets better with use.

Foundation: Local-first by default — all data stays in local plain text for privacy, ownership, and speed.

✨ Features

For Humans

• GUI Workbench: browse, edit, search notes with unified search + AI entry (⌘K / ⌘/), designed for human-AI co-creation.
• Built-in Agent Assistant: converse with the knowledge base in context; edits seamlessly capture human-curated knowledge.
• Plugin Extensions: multiple built-in renderer plugins — TODO Board, CSV Views, Wiki Graph, Timeline, Agent Inspector, and more.

For Agents

• MCP Server + Skills: stdio + HTTP dual transport, full-lineup Agent compatible (OpenClaw, Claude Code, Cursor, etc.). Zero-config access.
• Structured Templates: pre-set directory structures for Profiles, Workflows, Configurations, etc., to jumpstart personal context.
• Agent-Ready Docs: everyday notes naturally double as high-quality executable Agent commands — no format conversion needed, write and dispatch.

Infrastructure

• Security: Bearer Token auth, path sandboxing, INSTRUCTION.md write-protection, atomic writes.
• Knowledge Graph: dynamically parses and visualizes inter-file references and dependencies.
• Git Time Machine: Git auto-sync (commit/push/pull), records every edit by both humans and Agents. One-click rollback, cross-device sync.

<details> <summary><strong>Coming Soon</strong></summary>

• ACP (Agent Communication Protocol): connect external Agents (e.g., Claude Code, Cursor) and turn the knowledge base into a multi-Agent collaboration hub
• Deep RAG integration: retrieval-augmented generation grounded in your knowledge base for more accurate, context-aware AI responses
• Backlinks View: display all files that reference the current file, helping you understand how a note fits into the knowledge network
• Agent Inspector: render Agent operation logs as a filterable timeline to audit every tool call in detail

</details>

---

🚀 Get