Zotero MCP Server v0.1.0
Initial release of the Zotero MCP Server - a Model Context Protocol server that provides AI assistants with seamless access to Zotero research libraries.
Features
MCP Tools (9)
- search_items - Search and filter library items with rich query options
- get_item - Retrieve single items by key or DOI
- generate_citation - Format citations in 10,000+ styles (APA, Chicago, MLA, IEEE, etc.)
- extract_pdf_text - Extract full-text content from PDF attachments
- create_item - Add new items to your library
- update_item - Modify existing item metadata
- delete_items - Remove items (batch support up to 50)
- manage_collections - Create and organize collections
- manage_tags - Add and remove tags from items
MCP Resources (3)
- zotero://collections - Browse collection hierarchy
- zotero://tags - View all library tags
- zotero://citation-styles - List available citation styles
Core Capabilities
- Full TypeScript implementation with comprehensive type safety
- Smart caching system (templates: 1hr, metadata: 15min, searches: 5min)
- Automatic rate limiting with exponential backoff
- Robust error handling with user-friendly messages
- Support for both user and group libraries
Installation
From Source
```bash
git clone https://github.com/danielostrow/zotero-mcp-server.git
cd zotero-mcp-server
npm install
npm run build
```
Configuration
- Get your Zotero API key from https://www.zotero.org/settings/keys
- Create a `.env` file:
```env
ZOTERO_API_KEY=your_api_key_here
ZOTERO_USER_ID=your_user_id_here
```
Usage with Claude Desktop
Add to your Claude Desktop config:
```json
{
"mcpServers": {
"zotero": {
"command": "node",
"args": ["/absolute/path/to/zotero-mcp-server/dist/index.js"],
"env": {
"ZOTERO_API_KEY": "your_api_key_here",
"ZOTERO_USER_ID": "your_user_id_here"
}
}
}
}
```
Requirements
- Node.js 20.16.0 or higher
- Zotero account with API access
Documentation
- README.md - Complete documentation
- QUICKSTART.md - Quick setup guide
License
MIT