MCP.so
Sign In

MindOS

@GeminiLight

Repository

About MindOS

Local-first knowledge base MCP server. Let AI agents (Claude, Cursor, Gemini CLI, etc.) read and write your Markdown notes via MCP protocol. Supports Streamable HTTP and stdio transports.

#knowledge-base#mcp-server#ai-agent#markdown#local-first

Basic information

Category

AI & Agents

Transports

stdio

Publisher

GeminiLight

Submitted by

Gemini Light

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mindos": {
      "type": "http",
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_AUTH_TOKEN"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MindOS?

MindOS is a local-first knowledge base that lets AI agents read and write Markdown notes via the Model Context Protocol (MCP). It provides persistent memory for agents, stored on the user’s own machine in plain Markdown files.

How to use MindOS?

Install the package globally with npm install -g @geminilight/mindos, then run mindos onboard for interactive setup and mindos start to launch the app (port 3000) and MCP server (port 8787). Add the MCP server URL http://localhost:8787/mcp with a bearer token to your agent’s MCP configuration.

Key features of MindOS

  • Local-first storage using plain Markdown files
  • 20 MCP tools for reading and writing notes
  • Full-text search across the knowledge base
  • Git history tracking for each file
  • Backlink discovery between files
  • Supported by Claude Code, Cursor, Gemini CLI, Windsurf, and Cline

Use cases of MindOS

  • Give an AI agent a persistent, editable knowledge base on your local machine
  • Allow agents to search and retrieve information from your notes
  • Enable agents to create, update, and delete Markdown and CSV files
  • Track changes and history using built-in git integration
  • Provide startup context for agents via the bootstrap tool

FAQ from MindOS

—

Comments

More AI & Agents MCP servers

Perplexity Ask MCP Server

ppl-ai

The official MCP server implementation for the Perplexity API Platform

2.4K

Sequential Thinking Multi-Agent System (MAS)

FradSer

An advanced sequential thinking process using a Multi-Agent System (MAS) built with the Agno framework and served via MCP.

306

Unreal Engine Generative AI Support Plugin

prajwalshettydev

Unreal Engine plugin for LLM/GenAI models & MCP UE5 server. OpenAI GPT-5, Deepseek R1, Claude Opus/Sonnet, Gemini 3, Grok 4, Alibaba Qwen, Kimi, ElevenLabs TTS, Inworld, OpenRouter, Groq, GLM, Ollama, Local, Meshy, Tripo, Hunyuan3D, Rodin, fal, Dashscope, Seedream. NPC AI, agenti

622

🔎 GPT Researcher

assafelovic

An autonomous agent that conducts deep research on any data using any LLM providers

28.1K

MCP-NixOS - Because Your AI Assistant Shouldn't Hallucinate About Packages

utensils

MCP-NixOS - Model Context Protocol Server for NixOS resources

739