Zettel Memory

Exposes local-first Markdown memory vaults as an MCP server for AI agents to access and organize notes.

typescript

2

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "inchan-zettel-memory": {
      "command": "node",
      "args": [
        "packages/mcp-server/dist/cli.js",
        "--vault",
        "/tmp/test-vault",
        "--index",
        "/tmp/test-index.db"
      ]
    }
  }
}

Available tools

create_note

Create a new Markdown note with Front Matter. Returns the note UID, file path, and metadata.

read_note

Read a note by its unique ID with options to include metadata and backlinks analysis.

list_notes

List notes with filtering, sorting, and pagination across PARA categories and tags.

search_memory

Full-text search powered by SQLite FTS5 with ranking and snippet generation.

update_note

Update an existing note's title, content, metadata, or links with partial updates and automatic timestamping.

delete_note

Delete a note permanently with explicit confirmation and safety checks.

get_vault_stats

Get statistics about your vault, including counts by category and tag usage.

get_backlinks

Find all notes that link to a specific note.

get_metrics

Retrieve performance metrics for the MCP server.

find_orphan_notes

Identify notes without incoming or outgoing links.

find_stale_notes

Find notes that haven’t been updated recently.

get_organization_health

Assess overall health of your note organization and suggest improvements.

archive_notes

Batch-archive old or unused notes.

suggest_links

AI-powered link suggestions based on content similarity.