Skip to main content
Glama

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 test

MIT License.

Available Tools

4 tools
get_pageGet a saved pageA
Read-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 pagesA
Read-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 tagsA
Read-only

Lists every tag in use with the number of pages carrying it, most used first.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 4 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness3/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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 npm
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables 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.
      43
      1
      MIT