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

• 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

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

Settings

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