Skip to main content
Glama
quote-mcp

quote-mcp

by jmajerus

quote-mcp

A store of quotations from books, most of them paper books that exist only on the shelf, and of your own margin notes on them: structured records you can search, tag, repair, and cite. An MCP server lets an AI agent search and cite them; admin pages show everything to a person; and a public site can publish the collection, its concepts, and its maps.

The quotes come from Zotero notes and from an old Drupal site (workcreatively.org), and are tagged with concepts from that site's vocabulary of the human side of work. It complements corpus-mcp, which cites the books in the Calibre libraries, and quote-atlas, whose concept maps open the quotes tagged with each concept.

What it does

  • Import. Reads quote notes from Zotero, grades each, and flags what to check: a missing page, a possible OCR error, a work not yet in Zotero. Zotero notes tagged margin become notes of your own.

  • Search and cite. Full-text search over what quotes say, by concept (with narrower concepts), set, author, or work, and a citation with a real locator: CSL JSON, the Better BibTeX citekey, and a Pandoc citation.

  • Organise. Concepts in named schemes, with broader, narrower, related, and opposite relations, and named concept sets for maps, themes, and search.

  • Publish. A public site of the collection, its concepts, and (if you choose) its quotes, served from a snapshot holding only what's public, on the LAN or from a Cloudflare Worker: quotes.majerus.us.

quote-mcp never changes Zotero. Its MCP tools save quotes and change tags and comments; changes to quoted text are proposals a person accepts, and a person can edit a quote on the admin pages.

Related MCP server: mcp-quotes

Documentation

Document

For

MCP tools

Every tool, its arguments, and what it returns

The admin pages

The web interface at /admin, page by page, and the worklists

Importing quotes and notes

The sources, the forms the parser reads, grades, flags, works, and margin notes

Concepts, collections, and concept sets

Concept schemes, collections on the public site, and the sets file

WordNet synsets

Each concept's WordNet link, looked up on the WordNet server, and loading that server

Provenance stamps

Who or what saved each quote, above all whether a generative agent did

The public site

What's public, vocab/site.md, the snapshot, the Worker and its D1 replica, the pages, and the maps' API

Operations

Commands, settings, the server, deploying, and the status-bar items

Pandoc quote text

Extraction ownership, preserved line breaks, and the migration handoff to corpus-mcp

PLAN.md

The plan of record: design decisions, what the survey found, the phases, and open questions

Quick start

Requires Node.js 22 or later; better-sqlite3 compiles natively, so you also need a C++ toolchain and Python.

npm install
cp .env.example .env    # then set QUOTE_ZOTERO_LIBRARY and QUOTE_ZOTERO_API_KEY
npm run import          # sync Zotero and import its quote notes
npm run serve           # MCP at http://localhost:8010/mcp, admin pages at /admin

Register it with an MCP client, for example Claude Code:

claude mcp add --transport http quotes http://localhost:8010/mcp

npm run quotes -- config shows every setting and what each feature still needs. Run the tests with npm test. Configuration and deployment are in Operations.

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables querying and browsing SNOMED CT medical terminology concepts, including search, details, and hierarchy navigation via MCP tools.
      3
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      A read-only MCP server that provides conversational querying of quotations data (counts, values, lookups) via tools like quotation_stats, search_quotations, and find_by_number.
      -