How do I use Zettelkasten MCP Server?

This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

Zettelkasten MCP Server

by rreben

Overview Schema Source Related Servers Discussions Admin

Python

Local

Zettelkasten MCP Server

Dieses Repository implementiert einen Model Context Protocol (MCP) Server, der als Brücke zwischen Claude Desktop / Claude Code und deinem Zettelkasten (basierend auf tools4zettelkasten) fungiert.

Warum dieser MCP Server?

Die Bibliothek tools4zettelkasten bietet mächtige Python-Werkzeuge zur Verwaltung eines Zettelkastens (Dateinamen-Logik, Strukturen, Links). Dieser MCP Server macht diese Werkzeuge für KI-Assistenten wie Claude zugänglich.

Der Nutzen:

Direkter Zugriff: Claude kann deinen Zettelkasten nicht nur "sehen" (als Dateien), sondern versteht die Struktur (Verwandte Zettel, Hierarchien).
Sichere Manipulation: Statt dass die KI versucht, Dateien 'blind' umzubenennen, nutzt sie die getestete Logik der Bibliothek, um konsistente Dateinamen und IDs zu erzeugen.
Komplexe Analysen: Claude kann Fragen beantworten wie "Welche Themen hängen damit zusammen?", indem es die Graphen-Analyse der Bibliothek nutzt.

Architektur

┌─────────────────────────────────────────────────────────────┐
│                 Claude Desktop / Claude Code                │
└─────────────────────┬───────────────────────────────────────┘
                      │ stdio (JSON-RPC)
                      ▼
┌─────────────────────────────────────────────────────────────┐
│                 zettelkasten_mcp/server.py                  │
│  ┌───────────────────────────────────────────────────────┐  │
│  │  MCP Protocol Handler (FastMCP)                       │  │
│  └───────────────────────────────────────────────────────┘  │
│                          │                                  │
│  ┌───────────────────────▼───────────────────────────────┐  │
│  │  12 Tools                                             │  │
│  │  • list_input_files    • search_zettel                │  │
│  │  • stage_file          • get_zettel                   │  │
│  │  • preview_staging     • list_zettel                  │  │
│  │  • get_statistics      • get_links                    │  │
│  │  • find_related        • analyze_structure            │  │
│  │  • preview_reorganize  • execute_reorganize           │  │
│  └───────────────────────────────────────────────────────┘  │
│                          │                                  │
│  ┌───────────────────────▼───────────────────────────────┐  │
│  │  tools4zettelkasten (importlib)                       │  │
│  │  • persistency.PersistencyManager                     │  │
│  │  • handle_filenames                                   │  │
│  │  • reorganize                                         │  │
│  │  • analyse                                            │  │
│  └───────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────┘
                          │
                          ▼
        ┌─────────────────────────────────────┐
        │  ~/Dropbox/zettelkasten/            │
        │  ├── mycelium/  (567 Zettel)        │
        │  └── input/     (neue Notizen)      │
        └─────────────────────────────────────┘

Related MCP server: pando

Projektstruktur

~/Dropbox/zettelkasten_mcp/
├── README.md                    # Diese Datei
├── venv/                        # Python 3.11 Virtual Environment
│   └── bin/python               # Python-Interpreter für MCP
└── zettelkasten_mcp/
    ├── __init__.py
    ├── __main__.py              # Entry point: python -m zettelkasten_mcp
    └── server.py                # MCP Server mit allen Tools

Abhängigkeiten

Python-Version: 3.11+ (MCP erfordert >= 3.10)

Installierte Packages im venv:

mcp[cli] - MCP Protocol Library
flask, flask-wtf, flask-pagedown - Flask-Abhängigkeiten von tools4zettelkasten
graphviz, pyfiglet, inquirerpy, colorama, markdown - Weitere Abhängigkeiten

Externe Abhängigkeit (tools4zettelkasten):

Repository: rreben/tools4zettelkasten
Beschreibung: Python-Tools für das "Folgezettel"-Prinzip, Verwaltung alphanumerischer Sortierungen und Strukturanalyse.
Integration: Dieses Projekt importiert die Bibliothek direkt (via PYTHONPATH), um deren Logik für Parsing und Dateisystem-Operationen zu nutzen.

Konfiguration

Claude Desktop / Claude Code

Datei: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "zettelkasten": {
      "command": "/Users/rupertrebentisch/Dropbox/zettelkasten_mcp/venv/bin/python",
      "args": ["-m", "zettelkasten_mcp"],
      "env": {
        "PYTHONPATH": "/Users/rupertrebentisch/Library/CloudStorage/Dropbox/tools4zettelkasten",
        "TOOLS4ZETTELKASTEN_PATH": "/Users/rupertrebentisch/Library/CloudStorage/Dropbox/tools4zettelkasten",
        "ZETTELKASTEN": "/Users/rupertrebentisch/Dropbox/zettelkasten/mycelium",
        "ZETTELKASTEN_INPUT": "/Users/rupertrebentisch/Dropbox/zettelkasten/input"
      },
      "cwd": "/Users/rupertrebentisch/Dropbox/zettelkasten_mcp"
    }
  }
}

Umgebungsvariablen

Variable	Beschreibung	Standard
`ZETTELKASTEN`	Pfad zum Hauptordner des Zettelkastens	`~/Dropbox/zettelkasten/mycelium`
`ZETTELKASTEN_INPUT`	Pfad zum Input-Ordner für neue Notizen	`~/Dropbox/zettelkasten/input`
`TOOLS4ZETTELKASTEN_PATH`	Pfad zum tools4zettelkasten-Repository	`~/Library/CloudStorage/Dropbox/tools4zettelkasten`
`PYTHONPATH`	Muss tools4zettelkasten enthalten	(wie TOOLS4ZETTELKASTEN_PATH)

Tools-Übersicht

Input-Management

Tool	Parameter	Beschreibung
`list_input_files`	-	Zeigt alle Dateien im Input-Ordner
`preview_staging`	-	Vorschau der geplanten Umbenennungen
`stage_file`	`filename`	Benennt eine Datei nach Titel um

Zettelkasten-Abfragen

Tool	Parameter	Beschreibung
`get_zettel`	`identifier` (ID oder Filename)	Liest einen einzelnen Zettel
`search_zettel`	`query`, `limit=10`	Volltextsuche
`list_zettel`	`prefix=""`, `limit=50`	Listet Zettel (optional nach Topic)
`get_statistics`	-	Statistiken über den Zettelkasten

Struktur & Analyse

Tool	Parameter	Beschreibung
`get_links`	`identifier`	Ein-/ausgehende Links eines Zettels
`find_related`	`identifier`, `limit=5`	Verwandte Zettel (Links + Hierarchie)
`analyze_structure`	`topic=""`	Strukturanalyse (Tree + Links)

Reorganisation

Tool	Parameter	Beschreibung
`preview_reorganize`	-	Zeigt geplante Änderungen
`execute_reorganize`	`confirm=False`	Führt Reorganisation durch

Technische Hinweise

Import-Workaround

tools4zettelkasten hat in seiner __init__.py ein from .cli import *, das Click-Commands exportiert und dabei Modulnamen wie reorganize überschreibt. Der MCP-Server umgeht dies durch direkten Import via importlib:

import importlib
ro = importlib.import_module("tools4zettelkasten.reorganize")

Manuelles Testen

cd ~/Dropbox/zettelkasten_mcp

# Server-Import testen
PYTHONPATH="$HOME/Library/CloudStorage/Dropbox/tools4zettelkasten" \
ZETTELKASTEN="$HOME/Dropbox/zettelkasten/mycelium" \
ZETTELKASTEN_INPUT="$HOME/Dropbox/zettelkasten/input" \
./venv/bin/python -c "from zettelkasten_mcp.server import mcp; print('OK')"

# Tools testen
PYTHONPATH="$HOME/Library/CloudStorage/Dropbox/tools4zettelkasten" \
ZETTELKASTEN="$HOME/Dropbox/zettelkasten/mycelium" \
ZETTELKASTEN_INPUT="$HOME/Dropbox/zettelkasten/input" \
./venv/bin/python -c "
from zettelkasten_mcp.server import get_statistics
print(get_statistics())
"

MCP-Status in Claude Code prüfen

claude mcp list

Oder im Chat: /mcp

Deployment-Checkliste

Python 3.11+ installiert? (python3.11 --version)
venv erstellt? (python3.11 -m venv venv)

Dependencies installiert?

./venv/bin/pip install "mcp[cli]" flask flask-wtf flask-pagedown \
    graphviz pyfiglet inquirerpy colorama markdown mistune

claude_desktop_config.json konfiguriert?
Pfade korrekt? (Dropbox-Symlinks beachten!)
Claude Desktop/Code neu gestartet?

Beispiel-Nutzung

Du: "Was liegt im Input-Ordner?"
Claude: [ruft list_input_files auf]

Du: "Zeige mir den Zettel über Kreativität"
Claude: [ruft search_zettel(query="Kreativität") auf]

Du: "Welche Zettel sind mit 01_001 verwandt?"
Claude: [ruft find_related(identifier="01_001") auf]

Du: "Gib mir Statistiken"
Claude: [ruft get_statistics auf]

Erstellt am: 27. Januar 2026

This server cannot be deployed

Context All Your Agents Can ShareAgents share what they learn, hand off work, and hold it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Related MCP Connectors

Ainoova Tools
com.ainoova
Notes, tasks, habits, journal and 6 more tools Claude can read and change, with undo. Free.
Note Taking Project Management Health & Wellness
1
https://tools.ainoova.com/api/mcp
Stipp A
app.stipp
Notes and actions in one app. Let Claude or ChatGPT read and update them.
Note Taking Workplace & Productivity
1
https://my.stipp.app/api/mcp
Valta
si.valta
Notes and memory assistant: one Markdown vault that Claude, ChatGPT and any MCP client can share.
Note Taking Knowledge & Memory
1
https://valta.si/mcp
Engram B
ro.rootcause
A second brain for Claude: remembers your work, plans your day, encrypted under a key only you hold.
Knowledge & Memory Note Taking Workplace & Productivity
441
https://engram.rootcause.ro/mcp/directory

Related MCP Servers

zettelkasten-mcp
Knowledge & Memory Note Taking Developer Tools
Liam-Deacon
A
license
A
quality
D
maintenance
Implements the Zettelkasten knowledge management methodology, allowing you to create, link, explore and synthesize atomic notes through Claude and other MCP-compatible clients.
Updated 9 months ago (2026-02-11 16:51 UTC)
14
6
MIT
pando
Note Taking File Systems Knowledge & Memory
sigrmoff
A
license
Not graded
quality
B
maintenance
Enables Claude to search, read, write, and manage a local markdown vault through 8 tools, turning your notes into an AI-accessible knowledge base.
Updated 4 months ago (2026-07-15 23:34 UTC)
3 npm
AGPL 3.0
obsidian-vault-mcp
Note Taking File Systems
Adaptive-Edge
A
license
Not graded
quality
D
maintenance
Enables Claude to read, write, search, and manage an Obsidian vault with tools for notes, tags, folders, and full-text search.
Updated 8 months ago (2026-02-28 16:52 UTC)
20 npm
MIT
Zettelkasten MCP Server
Note Taking Knowledge & Memory
jaoki824
F
license
Not graded
quality
A
maintenance
Enables Claude and other MCP-compatible clients to create, link, tag, search, and update atomic notes stored as Markdown files, building a bidirectional knowledge graph with semantic relationships. Also supports exploring and synthesizing that graph through tools that surface linked, similar, central, and orphaned notes.
Updated 21 days ago (2026-10-14 16:09 UTC)
-

Zettelkasten MCP Server

Warum dieser MCP Server?

Architektur

Projektstruktur

Abhängigkeiten

Konfiguration

Claude Desktop / Claude Code

Umgebungsvariablen

Tools-Übersicht

Input-Management

Zettelkasten-Abfragen

Struktur & Analyse

Reorganisation

Technische Hinweise

Import-Workaround

Manuelles Testen

MCP-Status in Claude Code prüfen

Deployment-Checkliste

Beispiel-Nutzung

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

zettelkasten-mcp

pando

obsidian-vault-mcp

Zettelkasten MCP Server