Library MCP
Enables searching and retrieving content from Markdown knowledge bases, with capabilities for filtering by tags, text search, slugs/URLs, and date ranges.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Library MCP get recent posts with tag 'python'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
library-mcp is an MCP server for interacting with
Markdown knowledge bases. Basically, folders that may or may not have subfolders, that include
files with .md extension and start with metadata like:
----
title: My blog post
tags:
- python
- programming
url: /my-blog-post
---
# My blog post
Yesterday I was dreaming about...The typical workflow in the current verison is to retrieve recent content for a given tag, and then discuss using that tag:
Get the next 50 posts with tag "executive",
then tell me what I should do about this problem
I am running into: ...You can also do the same but by date ranges:
Summarize the blog posts I wrote in the past year.You might reasonably ask "why not just upload your entire blog into the context window?" and there are two places where this library outperforms that approach:
My blog corpus is much larger than most model's context windows today. Further, even if the context windows became exhaustively large, I wrote a lot of mediocre stuff in the past, so maybe omitting it's a feature.
I have a number of distinct Markdown knowledge bases, and this lets me operate across them in tandem.
Finally, this is a hobby project, intended for running locally on your laptop. No humans have been harmed using this software, but it does work pretty well!
Tools
This MCP server exposes these tools.
Content Search Tools
Tools for retrieving content into your context window:
get_by_tag- Retrieves content by tagget_by_text- Searches content for specific textget_by_slug_or_url- Finds posts by slug or URLget_by_date_range- Gets posts published within a date range
Tag Management Tools
Tools for navigating your knowledge base:
search_tags- Searches for tags matching a querylist_all_tags- Lists all tags sorted by post count and recency
Maintenance Tools
Tools for dealing with running the tool:
rebuild- Rebuilds the content index, useful if you have added more content, edited existing content, etc
Setup / Installation
These instructions describe installation for Claude Desktop on OS X. It should work similarly on other platforms.
Install Claude Desktop.
Clone library-mcp into a convenient location, I'm assuming
/Users/will/library-mcpMake sure you have
uvinstalled, you can follow these instructionsGo to Cladue Desktop, Setting, Developer, and have it create your MCP config file. Then you want to update your
claude_desktop_config.json. (Note that you should replacewillwith your user, e.g. the output ofwhoami.cd /Users/will/Library/Application Support/Claude vi claude_desktop_config.jsonThen add this section:
{ "mcpServers": { "library": { "command": "uv", "args": [ "--directory", "/Users/will/library-mcp", "run", "main.py", "/Users/will/irrational_hugo/content" ] } } }Close Claude and reopen it.
It should work...
Available Tools
7 toolsget_by_date_rangeB
Get posts published within a date range.
Args: start_date: the start date in ISO format (YYYY-MM-DD) end_date: the end date in ISO format (YYYY-MM-DD) limit: the maximum number of posts to return
Inputs: start_date (required), end_date (required), limit.
get_by_slug_or_urlB
Get a post by its slug or URL.
Args: identifier: the slug, URL, or path fragment to search for
Inputs: identifier (required).
get_by_tagC
Get blog content by its tag.
Args: tag: the tag associated with content limit: the number of results to include
Inputs: tag (required), limit.
get_by_textC
Get blog content by text in content.
Args: query: text for an exact match limit: the number of results to include
Inputs: query (required), limit.
list_all_tagsA
List all tags sorted by number of posts and most recent post.
Inputs: no named parameters.
rebuildA
Rebuild text index. Useful for when contents have changed on disk
Inputs: no named parameters.
search_tagsB
Search for tags matching the provided query.
Args: tag_query: partial or full tag name to search for limit: the maximum number of tags to return
Inputs: tag_query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Most tools have distinct purposes focused on different retrieval methods (by date, slug/URL, tag, text content) and tag operations, but 'get_by_slug_or_url' and 'get_by_text' could potentially overlap if users confuse slug/URL with text content queries. The descriptions help clarify, but there's minor ambiguity.
All tool names follow a consistent verb_noun pattern with underscores (e.g., get_by_date_range, list_all_tags, search_tags). The naming is predictable and readable throughout the set, with no deviations in style.
With 7 tools, this is well-scoped for a library/blog content server. It covers core retrieval operations and tag management without being overwhelming, and each tool serves a clear purpose in the domain.
The toolset provides good read/search coverage for blog content and tags, but lacks any create, update, or delete operations, which are notable gaps for a full CRUD lifecycle. Agents can retrieve and rebuild but not modify content, limiting workflow completeness.
Maintenance
Related MCP Connectors
KnowMan MCP server: search, ask, save and read your Knowledge Base from any MCP client.
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Serve a folder of Markdown notes as an MCP server: hybrid search, reading, and sourced answers.
Personal knowledge base MCP server with semantic search, auto-categorization, metadata extraction
Related MCP Servers
- AlicenseBqualityDmaintenanceA local MCP server that allows AI systems to search and retrieve information from a custom knowledge base generated from markdown files. It provides tools for natural language text search, category browsing, and specific content chunk retrieval.3MIT
- AlicenseAqualityDmaintenanceAn MCP server for managing Obsidian-style note vaults, providing tools for full-text search, note creation, and backlink tracking. It enables users to navigate, structure, and update their personal knowledge base through natural language.9MIT
- FlicenseNot gradedqualityCmaintenanceMCP server that enables full-text search and link navigation over Markdown files as a knowledge graph.-
- FlicenseNot gradedqualityDmaintenanceA CLI tool and MCP server that turns markdown documentation into a searchable, queryable knowledge base.-