markpin-mcp
Markpin MCP server
Source of @markpin/mcp 0.10.0: an MCP server that lets Claude, Cursor and other AI clients search and read the web pages and highlights you saved with Markpin, a Chrome extension that keeps them as Markdown files in a folder you own.
Usage and setup: mcp-server/README.md.
mcp-server/— the server (stdio, read-only unless--allow-write).shared/— the Markpin file format (parse/serialize), also used by the extension. Bundled into the npm package.glama.json,glama/Dockerfile— for the Glama directory only.
This repository is published from Markpin's main repository on every release, so pull requests are applied there by hand. Issues are welcome here.
yarn install && yarn build && yarn testMIT License.
Available Tools
4 toolsget_pageGet a saved pageARead-only
Returns one page in full: metadata, tags, summary, the reader's one-line note (note), reading state (bookmark, readAt or skimmedAt — at most one), extracted content, every clip with its note, highlight color and reaction mark (kind), the absolute path of the Markdown file, and absolute paths of clip images. Accepts a page id or its URL.
Inputs: idOrUrl (required).
list_recentList recent pagesARead-only
Lists the most recently updated pages, newest first. With bookmarked=true, lists pages with a reading bookmark, newest bookmark first.
Inputs: n, bookmarked.
list_tagsList tagsARead-only
Lists every tag in use with the number of pages carrying it, most used first.
Inputs: no named parameters.
searchSearch saved pagesARead-only
Full-text search over pages saved with Markpin (title, extracted content, clipped text, notes, tags). Returns page summaries ranked by relevance with a short snippet around the first match. With an empty query, lists the most recently updated pages (optionally filtered by tags). Summaries include readAt (when the user marked the page read) and bookmark (a reading bookmark: when it was set and, if placed inside the page, the sentence it points at).
Inputs: tags, limit, query, bookmarked.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct retrieval axis: recency (list_recent), relevance/full-text (search), single-page detail (get_page), and tag aggregation (list_tags). The one fuzzy boundary is that search with an empty query duplicates list_recent's behavior, but the descriptions call this out explicitly enough that an agent can still choose correctly.
Three of four tools follow a clean verb_noun pattern (list_recent, get_page, list_tags); `search` is a bare verb, a minor deviation from the pattern but unambiguous. No style mixing (camelCase vs snake_case) or chaotic variants.
Four tools is slim but proportionate for what appears to be a read-only retrieval companion to a browser bookmarking extension. Each tool covers a genuinely different access path, so none feels redundant padding, though the surface is close to thin.
The read side is thorough — pages, tags, notes, clips, reading state, and two listing orders are all reachable. However, there is no write path at all: an agent cannot save a page, add a note or clip, tag anything, or set read/bookmark state, which are the core lifecycle actions the descriptions imply exist in the underlying product.
Related MCP Connectors
Search, read, and safely update Markdown notes in your connected Phasoric knowledge vaults.
Search, save, and set reminders in your personal MarkIt library of links, posts, and notes.
Personal context for every AI: search, read, and write back to your private Markdown library.
Search your Glasp web and Kindle highlights, notes, and AI memories from any MCP client. Read-only.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceLocal markdown notes for any MCP client: ranked + semantic search, tags, todos, a wiki-link knowledge graph, daily notes, templates, and slash-command workflows. Pure-JS, local, no API keys.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables read-only, filesystem-based access to Obsidian vault Markdown notes, including full-text search, title/path search, and frontmatter or tag metadata lookup, all without running Obsidian or using a plugin/REST API.22 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to search, read, and list notes and tags in a Markdown vault using read-only tools.MIT
- AlicenseBqualityBmaintenanceEnables local hybrid search over Obsidian and Markdown vaults via MCP, combining vector retrieval, full-text search, reranking, graph navigation, and safe CRUD while keeping data local.431MIT