{"_id":"papersgpt-for-zotero","_rev":"2-e62a3a51e06e6dcc06dc464439e49ec7","name":"papersgpt-for-zotero","dist-tags":{"latest":"1.0.1"},"versions":{"0.0.1":{"name":"papersgpt-for-zotero","version":"0.0.1","keywords":["private","personal","local","documents","search"],"author":{"name":"awadb.vincent@gmail.com"},"license":"Apache-2.0","_id":"papersgpt-for-zotero@0.0.1","maintainers":[{"name":"docsagent","email":"awadb.vincent@gmail.com"}],"homepage":"https://github.com/papersgpt/papersgpt-for-zotero","bugs":{"url":"https://github.com/papersgpt/papersgpt-for-zotero/issues"},"bin":{"pz":"dist/cli.mjs","pgz":"dist/cli.mjs","papersgpt-for-zotero":"dist/cli.mjs"},"dist":{"shasum":"a81b6cc5a4610c165665587a8a21c5ba90bd9fa1","tarball":"https://registry.npmjs.org/papersgpt-for-zotero/-/papersgpt-for-zotero-0.0.1.tgz","fileCount":21,"integrity":"sha512-ugi31jf9z/IsUEUeb3r+lMKTy8cyI9Hvs9qqZl3ERYtPksUPDvndCxDOW7HpRPylb23+LRcEq6eOpidKASGUgQ==","signatures":[{"sig":"MEUCIAh/50f+5TM/nRKEP9Q58xGAI1byqF4fE0sVlWIwMzCpAiEAzON2EAlT2bvUAUpqCJIq6a41JCXUUTj+zeQWM7UgYTQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":142220017},"main":"dist/index.mjs","gitHead":"649d30239c72d86f26c8ac8dd5fa505855c17ee8","scripts":{"dev":"tsup src/index.ts --format esm --watch","build":"tsup src/index.ts src/cli.ts --format esm --tsconfig tsconfig.json --clean --minify","postinstall":"node scripts/install.mjs","prepublishOnly":"npm run build"},"_npmUser":{"name":"docsagent","email":"awadb.vincent@gmail.com"},"repository":{"url":"git+https://github.com/papersgpt/papersgpt-for-zotero.git","type":"git"},"_npmVersion":"10.9.2","description":"A privacy-first, local-first search assistant and MCP server for your Zotero library, enabling AI agents to search and analyze your research papers securely.","directories":{},"_nodeVersion":"22.15.0","dependencies":{"zod":"^3.22.4","tsup":"^8.0.0","typescript":"^5.0.0","@modelcontextprotocol/sdk":"^1.0.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/papersgpt-for-zotero_0.0.1_1776066183328_0.21527874436474748","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"papersgpt-for-zotero","version":"1.0.1","description":"A privacy-first, local-first search assistant and MCP server for your Zotero library, enabling AI agents to search and analyze your research papers securely.","main":"dist/index.mjs","bin":{"papersgpt-for-zotero":"dist/cli.mjs","pz":"dist/cli.mjs","pgz":"dist/cli.mjs"},"scripts":{"build":"tsup src/index.ts src/cli.ts --format esm --tsconfig tsconfig.json --clean --minify","dev":"tsup src/index.ts --format esm --watch","prepublishOnly":"npm run build","postinstall":"node scripts/install.mjs"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.1","tsup":"^8.0.0","typescript":"^5.0.0","zod":"^3.22.4"},"keywords":["private","personal","local","documents","search"],"author":{"name":"awadb.vincent@gmail.com"},"license":"Apache-2.0","publishConfig":{"access":"public"},"homepage":"https://github.com/papersgpt/papersgpt-for-zotero","repository":{"type":"git","url":"git+https://github.com/papersgpt/papersgpt-for-zotero.git"},"_id":"papersgpt-for-zotero@1.0.1","gitHead":"547bc8b4f907294579599f3c1feb676f71a20ce1","bugs":{"url":"https://github.com/papersgpt/papersgpt-for-zotero/issues"},"_nodeVersion":"22.15.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-oxAswP2WyVK9jHeIvKmiSg8qPatlX5TKFLDl55ePtxC5gvhX01G+jZu7lQ3Rb15vE96e6DfOxwGAcwcl9wTyGQ==","shasum":"2b433888ec2760cb10d8b29c0d2013b896515606","tarball":"https://registry.npmjs.org/papersgpt-for-zotero/-/papersgpt-for-zotero-1.0.1.tgz","fileCount":21,"unpackedSize":142220276,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDeKTuV9YNVvzihDS0y4C6Id0GEKCS3EURzaqCQpYD1egIgMDCjR2Mm/gKnKM5ODdOs3xTucg1rYnu5Oxv5bFwU61A="}]},"_npmUser":{"name":"docsagent","email":"awadb.vincent@gmail.com"},"directories":{},"maintainers":[{"name":"docsagent","email":"awadb.vincent@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/papersgpt-for-zotero_1.0.1_1778051991319_0.8870807391115856"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-13T07:43:03.233Z","modified":"2026-05-06T07:19:52.823Z","0.0.1":"2026-04-13T07:43:04.693Z","1.0.1":"2026-05-06T07:19:52.723Z"},"bugs":{"url":"https://github.com/papersgpt/papersgpt-for-zotero/issues"},"author":{"name":"awadb.vincent@gmail.com"},"license":"Apache-2.0","homepage":"https://github.com/papersgpt/papersgpt-for-zotero","keywords":["private","personal","local","documents","search"],"repository":{"type":"git","url":"git+https://github.com/papersgpt/papersgpt-for-zotero.git"},"description":"A privacy-first, local-first search assistant and MCP server for your Zotero library, enabling AI agents to search and analyze your research papers securely.","maintainers":[{"name":"docsagent","email":"awadb.vincent@gmail.com"}],"readme":"# PapersGPT for Zotero 🛡️\n\n**The High-Performance Local Intelligence Layer for AI Agents.**\n\nPapersGPT for Zotero is a professional, local-first documents intelligence engine and MCP (Model Context Protocol) server. It provides a secure, near-instant bridge between your private local files and advanced agentic platforms like **Claude Desktop**, **Claude Code**, and **Cursor**.\n\n**100% Local. 100% Private. Zero Data Leakage.**\n\n[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)\n[![OS: macOS / Windows / Linux](https://img.shields.io/badge/OS-macOS%20|%20Windows%20|%20Linux-black.svg)](#)\n\n---\n\n### 🔥 Why PapersGPT for Zotero?\n\nModern AI Agents are incredibly smart, but they are \"blind\" to your private desktop documents. PapersGPT for Zotero acts as a **High-Performance Intelligence Engine** that indexes your local data, allowing agents to search, read, and analyze thousands of files (1,000+) with absolute privacy.\n\n*   **🔒 Absolute Privacy:** All document parsing, indexing, and vector storage happen strictly on your own hardware. Your data never leaves your machine.\n*   **⚡ High-Performance Core:** Powered by a native C++ engine. Experience millisecond-level retrieval even across massive document libraries.\n*   **🔌 MCP Native:** Built-in support for the **Model Context Protocol (MCP)**, making it instantly compatible with the latest AI tools.\n*   **📂 Format Mastery:** Native parsing for PDF, Word (.docx), PPTX.\n*   **🤖 Local LLM Ready:** Works seamlessly with Claude 3.5/GPT-4o or run completely air-gapped with local models via Ollama.\n\n---\n\n### 🚀 Quick Start\n\n#### 1. Install via NPM\n```bash\nnpm install -g papersgpt-for-zotero\n```\n\n#### 2. CLI Usage (Local Indexing & Search)\nPapersGPT for Zotero provides a powerful CLI for managing your local knowledge base.\n\n*   **Initialize your Zotero library:**\n    ```bash\n    # Link your Zotero storage (auto-detects default path if omitted)\n    pz init \"/Users/me/Zotero/storage\"\n    ```\n*   **Search your documents:**\n    ```bash\n    # Perform a semantic search directly from the terminal\n    pz search \"What are the key findings in the 2023 climate study?\"\n    ```\n*   **Start the MCP Server:**\n    ```bash\n    # Start the MCP server for AI agents (Claude, Cursor, etc.)\n    pz mcp\n    ```\n\n---\n\n### 🔌 Agent Integration Examples\n\nConnect PapersGPT for Zotero to your favorite tools:\n\n#### **Claude Desktop**\nAdd the following to your `claude_desktop_config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"papersgpt-for-zotero\": {\n      \"command\": \"pz\",\n      \"args\": [\"mcp\"]\n    }\n  }\n}\n```\n\n#### **Claude Code**\nIntegrate with Anthropic's CLI tool:\n```bash\nclaude code mcp add pz -- pz mcp\n```\n\n#### **Cursor / Windsurf**\n1. Open **Settings** > **Features** > **MCP Servers**.\n2. Click **+ Add New MCP Server**.\n3. Name: `PapersGPTForZotero`\n4. Type: `command`\n5. Command: `pz mcp`\n\n---\n\n### 🛠️ Agent Tools (via MCP)\n\nOnce integrated, your AI agent gains professional-grade document capabilities through these tools:\n\n- **`search`**: Perform deep semantic search across your entire Zotero library to find relevant snippets.\n\n---\n\n### 💻 CLI Reference\n\nPapersGPT for Zotero provides a powerful CLI with convenient aliases (`pz`, `pgz`):\n\n| Command | Example | Description |\n| :--- | :--- | :--- |\n| `init` | `pz init` | Initialize the backend index and search service |\n| `search` | `pz search \"query\"`| Search for documents directly from CLI |\n| `mcp` | `pz mcp` | Start the MCP server (for AI agents) |\n| `stop`  | `pz stop` | Stop the background engine service |\n\n---\n\n### 📂 Support Matrix\n\n| Format | Status | Features |\n| :--- | :--- | :--- |\n| **PDF** | ✅ Full | Deep layout analysis & high-speed parsing |\n| **Word (.docx)** | ✅ Full | Table extraction & heading hierarchy preserved |\n| **PPTX** | ✅ Full | Extracts slides, shapes, and speaker notes |\n\n---\n\n### 🤝 Community & Contributing\n\nWe are building the open standard for Local RAG. Join us in making AI respect personal data sovereignty!\n\n- **GitHub Issues:** Found a bug? Have a feature request? Open an issue.\n- **Star the Repo:** If PapersGPT for Zotero improved your workflow, please give us a ⭐ to help others find the project!\n\n---\n\n### ⚖️ License\n\nPapersGPT for Zotero is open-source under the **Apache-2.0 License**.\n\n---\n**Desktop Sovereignty is here. Empower your Agents with PapersGPT for Zotero.**\n","readmeFilename":"README.md"}