Advertise
MCP.so
Sign In

MindOS MCP Server

@GeminiLight

Repository

Basic information

Category

AI & Agents

Transports

stdio

Author

GeminiLight

Submitted by

Gemini Light

About MindOS MCP Server

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

MindOS MCP Server 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"
      }
    }
  }
}

MindOS MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list directly from this server's endpoint using the button above.

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

Tokenaissance

Rain

Tokenaissance is a online Personal Agent for Quant and Research investment available at https://tokenaissance.com.

F

fhirHydrant

faulkj

Open-source Node.js FHIR MCP server with SMART Backend Services, metadata-aware search/CRUD tools, compact responses, FHIRPath filtering, safe pagination, audit events, and terminology lookup.

14

Hostinger

hostinger

Model Context Protocol (MCP) server for Hostinger API. If you don't want to install or run anything locally, connect directly to Hostinger's hosted MCP server: This opens a browser window to authorize via OAuth. Once app

148

Ranla

Kurtis Tryber

AI growth agent for software businesses. Ranla ships pages that rank on Google, gets your product named in AI answers, replies on Reddit and sends lifecycle email. Ask how growth is going, have Ranla draft the work and a

SlopIt: blogs for AI agents

SimbaStack

Blog MCP server for AI agents. One signup call returns a blog, an API key and a live URL; then your agent publishes markdown posts and gets public URLs back. Your agent does the writing; you get a dashboard for stats.

Advertise