filamental-mcp

What is filamental-mcp?

filamental-mcp is a local Model Context Protocol server that connects AI assistants (Claude Desktop, Claude Code) directly to a Filamental knowledge graph. It reads and writes the vault—searching nodes, following connections, creating and updating content—while Filamental is running or closed, and changes are immediately visible when Filamental opens.

How to use filamental-mcp?

Filamental-mcp can be set up through the Filamental app (Settings > AI Integrations > Connect to Claude Desktop) or manually by installing globally (npm install -g filamental-mcp) and adding its configuration to claude_desktop_config.json. For Claude Code, add a .mcp.json at the project root. No --vault argument is needed by default; the server reads the active vault automatically.

Key features of filamental-mcp

• Reads the same SQLite index Filamental uses.
• Writes both Markdown files and the SQLite index.
• Search nodes with full-text across names, notes, properties.
• Create, update, and delete nodes and edges.
• Get subgraph BFS traversal up to 3 hops.
• Automatic vault detection from Filamental.

Use cases of filamental-mcp

• Query your knowledge graph with natural language through Claude.
• Create new nodes and relationships directly from a chat.
• Search and connect information across multiple vaults.
• Automate knowledge graph updates without opening Filamental.

FAQ from filamental-mcp

What are the system requirements?

Node.js 22+ and the Filamental desktop app with at least one vault opened (to initialize the SQLite index).

How does filamental-mcp store and sync data?

It opens the SQLite index read-write. Read tools query the index directly; write tools update both the Markdown file on disk and the SQLite index so changes appear immediately when Filamental loads.

What are the known limitations?

• The pre-built better-sqlite3 binary is Windows x64 only; other platforms require building from source.
• The server must be restarted if you change the active vault in Filamental.
• Auto-config via Filamental Settings has been tested on Windows; macOS path resolution is included but untested.

What transports or authentication does the server use?

The README does not specify transport or authentication details. It is listed as an MCP server.

Is filamental-mcp open source?

Yes, it is licensed under MIT (Copyright Blackcat Marketing LLC).