Loading...
An MCP server for Zettelkasten knowledge management, enabling creation, linking, and exploration of atomic notes using Claude and other MCP-compatible clients.
Boost this tool
Subscribe to listing upgrades or segmented pushes.
An MCP server for Zettelkasten knowledge management, enabling creation, linking, and exploration of atomic notes using Claude and other MCP-compatible clients.
The Zettelkasten MCP server offers a balance between functionality and risk. It's relatively safe for read-only operations and knowledge exploration. However, write operations should be performed with caution, ensuring proper backups and understanding of the potential impact on the knowledge base.
Performance depends on the size of the Zettelkasten and the efficiency of the SQLite database. Rebuilding the index can be time-consuming for large knowledge bases.
The primary cost is the computational resources required to run the server. There are no external API calls, so costs are relatively low.
{
"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"
}
}
}
}zk_create_noteCreates a new note with a title, content, and optional tags.
Adds new content to the Zettelkasten.
zk_get_noteRetrieves a specific note by ID or title.
Read-only operation.
zk_update_noteUpdates an existing note's content or metadata.
Modifies existing content.
zk_delete_noteDeletes a note.
Removes content from the Zettelkasten.
zk_create_linkCreates links between notes.
Adds relationships between notes.
zk_remove_linkRemoves links between notes.
Removes relationships between notes.
zk_search_notesSearches for notes by content, tags, or links.
Read-only operation.
zk_get_linked_notesFinds notes linked to a specific note.
Read-only operation.
zk_get_all_tagsLists all tags in the system.
Read-only operation.
zk_find_similar_notesFinds notes similar to a given note.
Read-only operation.
zk_find_central_notesFinds notes with the most connections.
Read-only operation.
zk_find_orphaned_notesFinds notes with no connections.
Read-only operation.
zk_list_notes_by_dateLists notes by creation/update date.
Read-only operation.
zk_rebuild_indexRebuilds the database index from Markdown files.
Potentially overwrites database content.
None
The Zettelkasten MCP server offers a balance between functionality and risk. It's relatively safe for read-only operations and knowledge exploration. However, write operations should be performed with caution, ensuring proper backups and understanding of the potential impact on the knowledge base.
The server operates with read and write access by default. There is no sandboxing or rollback support, so caution is advised when using tools that modify or delete data.
Production Tip
Regularly back up the Markdown files to prevent data loss, especially before performing any write operations.
Simply back up the directory containing your Markdown files. These are the source of truth for your knowledge base.
You can delete the database file. It will be automatically rebuilt from the Markdown files when the server is restarted or when you run `zk_rebuild_index`.
Yes, you can edit the Markdown files using any text editor. However, you'll need to run `zk_rebuild_index` to update the database after making changes.
Add tags to the YAML frontmatter of your Markdown files. For example: `tags: [tag1, tag2]`.
No, there is no built-in authentication or access control. Anyone with access to the server can modify the Zettelkasten.
Yes, any MCP-compatible client should be able to interact with the server, although compatibility may vary.
Ensure that your SQLite database is properly indexed and that your Markdown files are well-organized. Avoid excessively large notes or complex link structures.