- MindOS
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.
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"
}
}
}
}Project Info
Created At
a month agoUpdated At
a month agoAuthor Name
GeminiLightStar
-Language
-License
-Recommend Servers
View Allmcp-server-flomo MCP Server
@chatmcp
Write notes to Flomo
JavaScript
a year ago
Haas.my — Humans As A Service
2 days ago
Acornonaut Mcp Server
@zerolve-io
8 hours ago
Mcp Server Chatsum
@chatmcp
summarize chat message
typescript
a year ago
Whitfield Advisory Internal Tools
2 days ago
Shivang
2 days ago