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

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

Basic information

Category

AI & Agents

Transports

stdio

Author

GeminiLight

Submitted by

Gemini Light

More AI & Agents MCP servers

Model Context Protocol Server for Home Assistant

tevonsb

A MCP server for Home Assistant

574

Just Prompt - A lightweight MCP server for LLM providers

disler

just-prompt is an MCP server that provides a unified interface to top LLM providers (OpenAI, Anthropic, Google Gemini, Groq, DeepSeek, and Ollama)

733

Hass-MCP

voska

Control and query Home Assistant from Claude and other LLMs — a Model Context Protocol (MCP) server.

307

LinkedIn MCP Server

stickerdaniel

Open-source MCP server for LinkedIn. Give Claude and any MCP-compatible AI agent access to profiles, companies, jobs, and messages.

2.7K

Solon Ai

opensolon

Java AI application development framework (supports LLM-tool,skill; RAG; MCP; Agent-ReAct,Team-Agent). Compatible with java8 ~ java25. It can also be embedded in SpringBoot, jFinal, Vert.x, Quarkus, and other frameworks.

416