zettelkasten-mcp

Overview

The Zettelkasten MCP server implements the classic Zettelkasten methodology for knowledge management, allowing users to create atomic notes with unique IDs, establish meaningful semantic links between ideas, and build a knowledge graph that supports both vertical and horizontal exploration. It uses a dual storage architecture with Markdown files as the source of truth and an SQLite database for efficient querying and relationship traversal. The server provides comprehensive tools for note management, search, and synthesis, making it particularly valuable for researchers, writers, and knowledge workers who need to organize and connect complex information.

Try asking AI

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

• zk_create_note

  Create a new note with a title, content, and optional tags

  Try:Create a new note about machine learning basicsTry:Add a note with tags 'research' and 'ai'
• zk_get_note

  Retrieve a specific note by ID or title

  Try:Get note with ID 2023-05-15-143022Try:Show me my note titled 'Project Ideas'
• zk_update_note

  Update an existing note's content or metadata

  Try:Update the content of my note about neural networksTry:Add more references to my research note
• zk_delete_note

  Delete a note

  Try:Remove the outdated note from last yearTry:Delete the temporary brainstorming note
• zk_create_link

  Create links between notes

  Try:Link my note about neural networks to my TensorFlow notesTry:Connect these two related ideas with a 'reference' link
• zk_remove_link

  Remove links between notes

  Try:Remove the connection between these notesTry:Unlink these two related topics
• zk_search_notes

  Search for notes by content, tags, or links

  Try:Find all notes about quantum computingTry:Search for notes tagged 'research'
• zk_get_linked_notes

  Find notes linked to a specific note

  Try:Show me all notes connected to my main project noteTry:What notes reference my article on blockchain?
• zk_get_all_tags

  List all tags in the system

  Try:Show me all available tagsTry:What categories are my notes organized into?
• zk_find_similar_notes

  Find notes similar to a given note

  Try:Find notes similar to my machine learning articleTry:What other notes relate to my philosophy of science note?
• zk_find_central_notes

  Find notes with the most connections

  Try:Show me the most connected notes in my systemTry:What are the hub notes in my knowledge base?
• zk_rebuild_index

  Rebuild the database index from Markdown files

  Try:Rebuild the index after editing notes outside the systemTry:Update the database with my latest note changes

Comparable tools

Installation

# Clone the repository
git clone https://github.com/entanglr/zettelkasten-mcp.git
cd zettelkasten-mcp

# Create a virtual environment with uv
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv add "mcp[cli]"

# Install devenuv sync --all-extras

{
  "mcpServers": {
    "zettelkasten": {
      "command": "/absolute/path/to/zettelkasten-mcp/.venv/bin/python",
      "args": [
        "-m",
        "zettelkasten_mcp.main"
      ],
      "env": {
        "ZETTELKASTEN_NOTES_DIR": "/absolute/path/to/zettelkasten-mcp/data/notes",
        "ZETTELKASTEN_DATABASE_PATH": "/absolute/path/to/zettelkasten-mcp/data/db/zettelkasten.db",
        "ZETTELKASTEN_LOG_LEVEL": "INFO"
      }
    }
  }
}

Compare zettelkasten-mcp with