flywheel-memory

Overview

Flywheel turns your Obsidian vault into a local memory layer for AI agents. It provides grounded search across notes with context, safe bounded writes back into the vault, and local indexes that stay on your machine. The system uses a 13-layer scoring mechanism that learns and improves over time. All processing happens locally with zero cloud dependencies, keeping your data private while giving AI agents access to structured knowledge about your notes.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• vault_search

  Search the vault with keywords or filters to find relevant notes

  Try:Find all invoices with status:sentTry:Search for notes about the AlphaFold project
• edit_section

  Edit or add content to a specific section in a note

  Try:Add a log entry about Stacy reviewing the security checklistTry:Update the project timeline in the planning note
• policy

  Create, preview, or execute vault policies that search and modify notes

  Try:Create a policy to find overdue invoices and create follow-up tasksTry:Preview the monthly-report policyTry:Execute the project-update policy
• memory

  Access or update the memory system, including briefings and observations

  Try:Give me a brief summary of recent activityTry:Log an observation about the client meeting
• graph

  Export or analyze the knowledge graph of notes and links

  Try:Export the vault as GraphMLTry:Show me connections between the Acme and Beta Corp projects

Note: Tool names extracted from descriptions and examples in the README, but without detailed signatures. The README mentions multiple tools but doesn't provide a complete list or explicit documentation of all MCP tools.

Comparable tools

Installation

{
  "mcpServers": {
    "flywheel": {
      "command": "npx",
      "args": ["-y", "@velvetmonkey/flywheel-memory"]
    }
  }
}

FAQ

How does Flywheel handle privacy?

All processing happens locally with zero cloud dependencies. Your notes remain readable Markdown, and Flywheel's state is stored locally beside your vault.

Can I use Flywheel with other clients besides Claude?

Yes, Flywheel works with any MCP-compatible client. Manual configuration is required for non-Claude clients like Cursor, Windsurf, and VS Code.

Compare flywheel-memory with