DocsAgent
DocsAgent is a local-first AI documents assistant that lets you securely index and chat with thousands of desktop documents with zero cloud leakage.
What is DocsAgent?
DocsAgent is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to docsagent is a local-first ai documents assistant that lets you securely index and chat with thousands of desktop documents with zero cloud leakage.
DocsAgent is a local-first AI documents assistant that lets you securely index and chat with thousands of desktop documents with zero cloud leakage.
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- DocsAgent is a local-first AI documents assistant that lets
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx docsagentConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use DocsAgent
DocsAgent is a local-first AI document assistant that indexes thousands of desktop files — PDFs, Word documents, and PowerPoint presentations — and makes them searchable through deep semantic search, all without uploading content to any cloud service. It exposes an MCP server so that AI agents can perform semantic search across your local document library and index new files or folders on-the-fly during a conversation. Professionals handling sensitive documents such as legal contracts, research papers, or proprietary reports can use DocsAgent to query their entire library with natural language while keeping everything private.
Prerequisites
- Node.js 18 or later (for the npm-based CLI)
- npm package @docsagent/docsagent installed globally
- Documents available locally in PDF, DOCX, or PPTX format
- An MCP-compatible client such as Claude Desktop
Install DocsAgent globally
Install the @docsagent/docsagent package globally so the 'docsagent' CLI command is available system-wide.
npm install -g @docsagent/docsagentIndex your document folders
Use the 'docsagent add' command to index one or more local directories. DocsAgent will parse and embed all PDFs, DOCX, and PPTX files it finds.
docsagent add ~/Documents/Research ~/Documents/ContractsTest search from the CLI
Verify the index is working by running a search query from the command line before connecting via MCP.
docsagent search "key terms in the NDA signed with Acme Corp"Start the MCP server
Launch DocsAgent in MCP server mode. The server exposes the 'search' and 'add_docs' tools over stdio for MCP clients.
docsagent serverAdd DocsAgent to your MCP client config
Add DocsAgent to your claude_desktop_config.json so Claude can search and index documents through the MCP protocol.
{
"mcpServers": {
"docsagent": {
"command": "npx",
"args": ["docsagent", "server"]
}
}
}DocsAgent Examples
Client configuration
claude_desktop_config.json entry for DocsAgent running as an MCP server in server mode.
{
"mcpServers": {
"docsagent": {
"command": "npx",
"args": ["docsagent", "server"]
}
}
}Prompts to try
Example prompts that use the semantic search and document indexing tools exposed by DocsAgent.
- "Search my documents for anything related to GDPR compliance requirements."
- "Find all contracts that mention a termination clause and summarize the conditions."
- "Index the folder ~/Downloads/Q2Reports and then search for revenue projections."
- "What does my research library say about transformer attention mechanisms?"
- "Find the slides from last quarter's board presentation that discuss headcount."Troubleshooting DocsAgent
No results returned for a search query
Make sure you have indexed the relevant folders first with 'docsagent add <path>'. The index is built locally and must be populated before search will return results.
PDF parsing returns empty or garbled text
DocsAgent performs layout analysis on PDFs. Scanned image-only PDFs without embedded text layers may not be parsed. Convert them to text-searchable PDFs using OCR tools like ocrmypdf first.
MCP server not found or tools not appearing in Claude
Ensure @docsagent/docsagent is installed globally (npm list -g @docsagent/docsagent). If using npx without a global install, add '--yes' to force download: 'npx --yes docsagent server'.
Frequently Asked Questions about DocsAgent
What is DocsAgent?
DocsAgent is a Model Context Protocol (MCP) server that docsagent is a local-first ai documents assistant that lets you securely index and chat with thousands of desktop documents with zero cloud leakage. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install DocsAgent?
Follow the installation instructions on the DocsAgent GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with DocsAgent?
DocsAgent works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is DocsAgent free to use?
Yes, DocsAgent is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
DocsAgent Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to DocsAgent? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up DocsAgent in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use DocsAgent?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.