Zettelkasten MCP Server
About
A Model Context Protocol (MCP) server that implements the Zettelkasten knowledge management methodology, allowing you to create, link, explore and synthesize atomic notes through Claude and other MCP-compatible clients.
Details
- License
- MIT
Explore
- Create atomic notes with unique timestamp-based IDs
- Link notes bidirectionally to build a knowledge graph
- Tag notes for categorical organization
- Search notes by content, tags, or links
- Use markdown format for human readability and editing
- Integrate with Claude through MCP for AI-assisted knowledge management
- Dual storage architecture (see below)
- Synchronous operation model for simplified architecture
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Zettelkasten MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv add "mcp[cli]"
uv sync --all-extras
uv run pytest -v tests/test_models.py
uv run pytest -v tests/test_models.py::TestNoteModel
uv run pytest -v tests/test_models.py::TestNoteModel::test_note_validation
zk_create_note
Create a new note with a title, content, and optional tags
zk_get_note
Retrieve a specific note by ID or title
zk_update_note
Update an existing note's content or metadata
zk_delete_note
Delete a note
zk_create_link
Create links between notes
zk_remove_link
Remove links between notes
zk_search_notes
Search for notes by content, tags, or links
zk_get_linked_notes
Find notes linked to a specific note
zk_get_all_tags
List all tags in the system
zk_find_similar_notes
Find notes similar to a given note
zk_find_central_notes
Find notes with the most connections
zk_find_orphaned_notes
Find notes with no connections
zk_list_notes_by_date
List notes by creation/update date
zk_rebuild_index
Rebuild the database index from Markdown files
All tools have been prefixed with zk_ for better organization:
| Tool | Description |
|---|---|
| zk_create_note | Create a new note with a title, content, and optional tags |
| zk_get_note | Retrieve a specific note by ID or title |
| zk_update_note | Update an existing note's content or metadata |
| zk_delete_note | Delete a note |
| zk_create_link | Create links between notes |
| zk_remove_link | Remove links between notes |
| zk_search_notes | Search for notes by content, tags, or links |
| zk_get_linked_notes | Find notes linked to a specific note |
| zk_get_all_tags | List all tags in the system |
| zk_find_similar_notes | Find notes similar to a given note |
| zk_find_central_notes | Find notes with the most connections |
| zk_find_orphaned_notes | Find notes with no connections |
| zk_list_notes_by_date | List notes by creation/update date |
| zk_rebuild_index | Rebuild the database index from Markdown files |
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"zettelkasten mcp server": {
"zettelkasten-mcp": {
"command": "uv",
"args": [
"venv"
]
}
}
}
}McpServers
{
"zettelkasten-mcp": {
"command": "uv",
"args": [
"venv"
]
}
}A Model Context Protocol (MCP) server that implements the Zettelkasten knowledge management methodology, allowing you to create, link, explore and synthesize atomic notes through Claude and other MCP-compatible clients.
What is Zettelkasten?
The Zettelkasten method is a knowledge management system developed by German sociologist Niklas Luhmann, who used it to produce over 70 books and hundreds of articles. It consists of three core principles:
1. Atomicity: Each note contains exactly one idea, making it a discrete unit of knowledge
2. Connectivity: Notes are linked together to create a network of knowledge, with meaningful relationships between ideas
3. Emergence: As the network grows, new patterns and insights emerge that weren't obvious when the individual notes were created
What makes the Zettelkasten approach powerful is how it enables exploration in multiple ways:
- Vertical exploration: dive deeper into specific topics by following connections within a subject area.
- Horizontal exploration: discover unexpected relationships between different fields by traversing links that cross domains.
This structure invites serendipitous discoveries as you follow trails of thought from note to note, all while keeping each piece of information easily accessible through its unique identifier. Luhmann called his system his "second brain" or "communication partner" - this digital implementation aims to provide similar benefits through modern technology.
Features
- Create atomic notes with unique timestamp-based IDs
- Link notes bidirectionally to build a knowledge graph
- Tag notes for categorical organization
- Search notes by content, tags, or links
- Use markdown format for human readability and editing
- Integrate with Claude through MCP for AI-assisted knowledge management
- Dual storage architecture (see below)
- Synchronous operation model for simplified architecture
Examples
- Knowledge creation: A small Zettelkasten knowledge network about the Zettelkasten method itself
Note Types
The Zettelkasten MCP server supports different types of notes:
|Type|Handle|Description|
|---|---|---|
|Fleeting notes|fleeting|Quick, temporary notes for capturing ideas|
|Literature notes|literature|Notes from reading material|
|Permanent notes|permanent|Well-formulated, evergreen notes|
|Structure notes|structure|Index or outline notes that organize other notes|
|Hub notes|hub|Entry points to the Zettelkasten on key topics|
Link Types
The Zettelkasten MCP server uses a comprehensive semantic linking system that creates meaningful connections between notes. Each link type represents a specific relationship, allowing for a rich, multi-dimensional knowledge graph.
| Primary Link Type | Inverse Link Type | Relationship Description |
|-------------------|-------------------|--------------------------|
| reference | reference | Simple reference to related information (symmetric relationship) |
| extends | extended_by | One note builds upon or develops concepts from another |
| refines | refined_by | One note clarifies or improves upon another |
| contradicts | contradicted_by | One note presents opposing views to another |
| questions | questioned_by | One note poses questions about another |
| supports | supported_by | One note provides evidence for another |
| related | related | Generic relationship (symmetric relationship) |
Prompting
To ensure maximum effectiveness, we recommend using a system prompt ("project instructions"), project knowledge, and an appropriate chat prompt when asking the LLM to process information, or explore or synthesize your Zettelkasten notes. The docs directory in this repository contains the necessary files to get you started:
System prompts
Pick one:
- system-prompt.md
- system-prompt-with-protocol.md
Project knowledge
For end users:
- zettelkasten-methodology-technical.md
- link-types-in-zettelkasten-mcp-server.md
- (more info relevant to your project)
Chat Prompts
- chat-prompt-knowledge-creation.md
- chat-prompt-knowledge-creation-batch.md
- chat-prompt-knowledge-exploration.md
- chat-prompt-knowledge-synthesis.md
Project knowledge (dev)
For developers and contributors:
- Example - A simple MCP server.md
- MCP Python SDK-README.md
- llms-full.txt
NB: Optionally include the source code with a tool like repomix.
Storage Architecture
This system uses a dual storage approach:
1. Markdown Files: All notes are stored as human-readable Markdown files with YAML frontmatter for metadata. These files are the source of truth and can be:
- Edited directly in any text editor
- Placed under version control (Git, etc.)
- Backed up using standard file backup procedures
- Shared or transferred like any other text files
2. SQLite Database: Functions as an indexing layer that:
- Facilitates efficient querying and search operations
- Enables Claude to quickly traverse the knowledge graph
- Maintains relationship information for faster link traversal
- Is automatically rebuilt from Markdown files when needed
If you edit Markdown files directly outside the system, you'll need to run the zk_rebuild_index tool to update the database. The database itself can be deleted at any time - it will be regenerated from your Markdown files.
Installation
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
