Docusense

Local MCP server and Claude Code plugin that indexes PDF, DOCX, HTML and Markdown files so Claude reads them by section and claim instead of loading whole files. Every passage carries a SHA-256 verified citation, and re-added files become new versions with diffs, blame and cross-document contradiction checks.

Documentation

DocuSense

DocuSense

DocuSense

Stop pasting whole documents into your agent.

DocuSense is a local MCP server that lets Claude, Cursor and other AI agents read your PDFs, Word files and docs by section and by claim, so they load the few hundred tokens that answer the question instead of the whole 50,000-token file. Every answer comes with a citation to the exact passage.

pasting the docs   ████████████████████████████████████████  160,179 tokens
vector RAG         ████                                         15,765 tokens
DocuSense          ██                                            6,869 tokens   → 23x less than pasting

Install

uv tool install docusense-mcp        # or: pipx install docusense-mcp
docusense setup                      # connects to Claude Code
docusense add ~/docs contract.pdf    # files or whole folders

That's it. Ask your agent about your documents.

Other clients: docusense setup claude-desktop, docusense setup cursor, or docusense setup print for a config snippet to paste anywhere. Claude Desktop users can also install the one-click docusense.mcpb from the releases page.

Supported files: PDF, Word (.docx), HTML, Markdown, plain text.

See what you saved

Example:

$ docusense savings
12 agent sessions · 87 tool calls
read via DocuSense:         41,302 tokens
pasting the docs:          912,440 tokens
saved:                     871,138 tokens (22.1x less context)

Why it uses fewer tokens

You askPasting the docsVector RAGDocuSense
A precise fact, with a citation9,090 tokens5,362 tokens of nearby chunks478 tokens: the exact paragraph
What changed between two versions97,895 tokens5,292 tokens, can't diff2,776 tokens: just the changes
Does document A conflict with B?53,194 tokens5,111 tokens, hit or miss3,615 tokens: both conflicting passages
  • Reads like a person. Your agent sees the table of contents, opens the right section, and reads only the paragraph it needs.
  • Tracks versions. Add a changed file again and DocuSense keeps both versions. Ask what changed without loading either one.
  • Finds contradictions between documents, with both sides cited.
  • Citations you can trust. Every passage is fingerprinted, so a made-up quote can't pass as a real one.
  • Private and free. Runs on your machine. No API key, no account, nothing uploaded.

Great for

  • Long specs, API references and design docs while coding in Claude Code or Cursor
  • Checking policies against standards and tracking revisions
  • Contracts, handbooks and research papers where you need exact quotes and page numbers
  • Any agent that keeps re-reading the same large files

If your documents are a few short files that already fit in context, you don't need DocuSense.

What your agent can do

Browselist documents, view the table of contents, read a section
Findsearch, find requirements and rules, look up definitions, follow cross-references
Citeget a verified quote, pack evidence into a token budget
Comparelist versions, diff versions, see when a line changed, find contradictions, find affected documents
Addadd files on its own and track progress

Set DOCUSENSE_TOOLS=core for a smaller tool set if your agent's context is tight.

Settings

VariableDefault
DOCUSENSE_HOME~/.docusensewhere your data lives
DOCUSENSE_ADD_ROOTSyour home folderfolders the agent may add files from
DOCUSENSE_TOOLSallcore for fewer tools
DOCUSENSE_SAVINGS_LOG10 turns off the local savings log

Share one library across several agents: docusense serve-mcp --http (set DOCUSENSE_HTTP_TOKEN when exposing it beyond localhost).

The first time you add documents, DocuSense downloads a small local search model (~130 MB) once.

License

MIT