MindOS
@GeminiLight
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.
Overview
What is MindOS?
MindOS is a local-first knowledge base that lets AI agents read and write your Markdown notes via MCP. Think of it as persistent memory for your agents — stored on your own machine, in plain Markdown files.
Quick Start
# Install and start
npm install -g @geminilight/mindos
mindos onboard # interactive setup
mindos start # starts app (port 3000) + MCP server (port 8787)
Then add to your agent's MCP config:
{
"mcpServers": {
"mindos": {
"url": "http://localhost:8787/mcp",
"headers": { "Authorization": "Bearer your-token" }
}
}
}
Available Tools (20)
┌─────────────────────────────┬──────────────────────────────────────┐
│ Tool │ Description │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_list_files │ List all files in the knowledge base │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_read_file │ Read file content (with pagination) │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_write_file │ Overwrite file content │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_create_file │ Create a new .md or .csv file │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_delete_file │ Delete a file │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_search_notes │ Full-text search across all files │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_get_recent │ Get recently modified files │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_append_to_file │ Append content to end of file │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_insert_after_heading │ Insert after a Markdown heading │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_update_section │ Replace a Markdown section │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_get_backlinks │ Find files referencing a given path │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_bootstrap │ Load startup context for agents │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_get_history │ Get git commit history for a file │
├─────────────────────────────┼──────────────────────────────────────┤
│ ... │ (20 tools total) │
└─────────────────────────────┴──────────────────────────────────────┘
Supported Agents
Claude Code · Cursor · Gemini CLI · Windsurf · Cline · and more
Server Config
{
"mcpServers": {
"mindos": {
"type": "http",
"url": "http://localhost:3000/mcp",
"headers": {
"Authorization": "Bearer YOUR_AUTH_TOKEN"
}
}
}
}