mcp-server-zotero-dev
Give your AI assistant superpowers for Zotero plugin development. 28 tools for screenshots, DOM inspection, JavaScript execution, build integration, and debugging via Model Context Protocol.
Install / Use
claude mcp add introfini -- npx -y github:introfini/mcp-server-zotero-devIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of mcp-server-zotero-dev
mcp-server-zotero-dev scores 87/100 on our quality scale, 1957th of 4,705 Development & Engineering skills we index (top 42%).
Its MCP Server is 19 KB long, well organised into 26 sections with 13 code examples: a thorough specification that gives an agent plenty to work with.
It has 43 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 7 days ago, so mcp-server-zotero-dev is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-11-21. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
mcp-server-zotero-dev compared with similar skills
All 4 of these similar skills score higher than mcp-server-zotero-dev; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| mcp-server-zotero-dev (this skill)by introfini | 87 | 43 | 7d ago | MCP Server |
| taste-skillby Leonxlnx | 100 | 120.0k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 114.0k | today | CLAUDE.md |
| hyperframesby heygen-com | 100 | 88.2k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.3k | today | CLAUDE.md |
Frequently asked questions
- How do I install mcp-server-zotero-dev?
- Run
claude mcp add introfini -- npx -y github:introfini/mcp-server-zotero-dev. The install tabs above show the steps for each supported agent. - Which AI agents does mcp-server-zotero-dev work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is mcp-server-zotero-dev safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is mcp-server-zotero-dev still maintained?
- The repository was last updated 7 days ago, so mcp-server-zotero-dev is actively maintained.
Skill content
View source on GitHubMCP Server Zotero Dev
Give your AI assistant superpowers for Zotero plugin development
Architecture · Getting Started · Available Tools
<img src="docs/images/demo.png" alt="MCP Server Zotero Dev in action" width="800"> </div>A Model Context Protocol (MCP) server that enables AI assistants like Claude, Cursor, and Windsurf to build, test, and debug Zotero 7, 8, 9, and 10 plugins. Screenshots, DOM state, debug logs, and JavaScript execution give the AI rich context to understand what's happening—and tools to help you fix it.
✨ Features
| Category | Capabilities | |----------|-------------| | 🎯 UI Inspection | Screenshots, DOM tree, element finding, computed styles | | 🖱️ UI Interaction | Click elements and type text (shadow-DOM aware) | | 💻 JS Execution | Run code in Zotero context, inspect APIs, test snippets | | 🔧 Build Tools | Scaffold integration for build, serve, hot reload | | 📋 Logs & Errors | Stream debug output, error console, watch for issues | | 🗃️ Database | Read-only access to zotero.sqlite for debugging | | 🔌 Plugin Management | Install, reload, list plugins |
🚀 Quick Start
Prerequisites
- Node.js 20+ and npm
- Zotero 7+ — Works on all Zotero 7, 8, 9, and 10 builds (release, beta, dev)
- For plugin development: zotero-plugin-scaffold
1. Install MCP Server
Use install-mcp to add the server to your AI assistant:
npx -y install-mcp @introfini/mcp-server-zotero-dev --client claude-code
Supported clients: claude-code, cursor, windsurf, vscode, cline, roo-cline, claude, zed, goose, warp, codex
npx -y install-mcp @introfini/mcp-server-zotero-dev --client claude-code
</details>
<details>
<summary><strong>Cursor</strong></summary>
npx -y install-mcp @introfini/mcp-server-zotero-dev --client cursor
</details>
<details>
<summary><strong>VS Code / Copilot</strong></summary>
npx -y install-mcp @introfini/mcp-server-zotero-dev --client vscode
</details>
<details>
<summary><strong>Windsurf</strong></summary>
npx -y install-mcp @introfini/mcp-server-zotero-dev --client windsurf
</details>
<details>
<summary><strong>Manual Configuration</strong></summary>
Add to your MCP client config:
{
"mcpServers": {
"zotero-dev": {
"command": "npx",
"args": ["-y", "@introfini/mcp-server-zotero-dev@1.1.1"],
"env": {
"ZOTERO_RDP_PORT": "6100"
}
}
}
}
</details>
Version & updates: pin an exact version as shown above. A bare
npx <pkg>(no version) keeps running whatevernpxcached and won't pick up new releases, so always include a version and-y(without-y,npxhangs waiting for an install prompt). Bump the pinned version to upgrade, or use@latestto always fetch the newest at launch (auto-updates, but a bad release would run automatically and it adds a registry check on every start). Note thatinstall-mcpmay write a config without-yor a version, so the manual configuration above is the most robust path.
Restart your AI assistant after adding the configuration.
2. Install MCP Bridge Plugin in Zotero
Download zotero-mcp-bridge.xpi and install:
- In Zotero: Tools → Plugins
- Click ⚙️ → Install Plugin From File
- Select the downloaded
.xpifile - Restart Zotero
This lightweight plugin enables the Remote Debugging Protocol when Zotero starts. It only needs to be installed once and works on all Zotero 7+ builds (release, beta, and dev).
3. Start Developing!
Just open Zotero normally and ask your AI assistant:
"Take a screenshot of Zotero and list installed plugins"
That's it! No special launch flags, no configuration. 🎉
🧰 Available Tools (28 total)
<details> <summary><strong>UI Inspection</strong> — Screenshots, DOM, styles</summary>| Tool | Description |
|------|-------------|
| zotero_screenshot | Capture window, element, or region screenshots |
| zotero_inspect_element | Find elements by CSS selector |
| zotero_get_dom_tree | Get DOM structure of a window/panel |
| zotero_get_styles | Get computed CSS styles for element |
| zotero_list_windows | List all open Zotero windows |
</details> <details> <summary><strong>UI Interaction</strong> — Click and type in the Zotero UI</summary>Screenshot Targets: Main window, preferences, PDF reader, dialogs, or any element by selector. Use
highlightSelectorto add a red border before capture.
| Tool | Description |
|------|-------------|
| zotero_click_element | Click an element by CSS selector (toolbar/menu button, preference control, list row). Pierces shadow DOM; index picks among multiple matches; mouseEvents synthesizes a full mouse sequence. |
| zotero_send_keys | Type text into an input/textarea/contenteditable (focuses it first, fires input/change). Optional clear and pressEnter. |
</details> <details> <summary><strong>JavaScript Execution</strong> — Run code in Zotero context</summary>Resolution tries light DOM first, then pierces open shadow roots (Zotero's XUL custom elements keep internals in shadow DOM). Limitation: cannot dismiss a blocking native modal dialog (
Services.prompt.confirmEx) — its nested modal loop blocks the eval thread these tools run on.
| Tool | Description |
|------|-------------|
| zotero_execute_js | Execute JavaScript in Zotero's privileged context. Auto-wraps code with top-level return statements in IIFE. |
| zotero_inspect_object | Explore Zotero APIs - list methods and properties of any object (e.g., Zotero.Items) |
| zotero_open_preferences | Open Zotero's settings window, optionally to a specific pane (built-in or plugin) |
| zotero_search_prefs | Search/discover preferences by pattern (e.g., find all prefs containing "debug") |
| zotero_get_pref | Get a preference value |
| zotero_set_pref | Set a preference value |
</details> <details> <summary><strong>Build & Scaffold</strong> — Integration with zotero-plugin-scaffold</summary>Examples:
Zotero.Items.getAll(1),Zotero.Prefs.get('export.quickCopy.setting'),ZoteroPane.getSelectedItems()Tip: Use
zotero_inspect_objectto explore APIs before writing code. Usezotero_search_prefsto discover preference keys.
| Tool | Description |
|------|-------------|
| zotero_scaffold_build | Build plugin (dev or production mode) |
| zotero_scaffold_serve | Start dev server with hot reload |
| zotero_scaffold_lint | Run ESLint on plugin source |
| zotero_scaffold_typecheck | Run TypeScript type checking |
| Tool | Description |
|------|-------------|
| zotero_read_logs | Read debug output (Zotero.debug) |
| zotero_read_errors | Read error console entries |
| zotero_watch_logs | Stream logs in real-time |
| zotero_clear_logs | Clear log buffer |
| Tool | Description |
|------|-------------|
| zotero_plugin_reload | Hot reload your dev plugin |
| zotero_plugin_install | Install plugin from XPI path |
| zotero_plugin_list | List installed plugins with version/status |
| Tool | Description |
|------|-------------|
| zotero_db_query | Execute SELECT query on zotero.sqlite |
| zotero_db_schema | Get table schema information |
| zotero_db_stats | Get database statistics (items, attachments, collections, size) |
</details>Note: Database access is read-only and requires Zotero to be closed, or uses a copy of the database.
🏗️ Architecture
┌─────────────────────────────────────────────────────────────────┐
│ AI Assistant │
│ (Claude, Cursor, Windsurf) │
└─────────────────────────┬───────────────────────────────────────┘
│ MCP Protocol (stdio)
▼
┌─────────────────────────────────────────────────────────────────┐
│ MCP Server (Node.js/TypeScript) │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────────────┐ │
│ │ Scaffold │ │ RDP │ │ Database │ │
│ │ Integration │ │ Client │ │ Reader │ │
│ └──────────────┘ └──────┬───────┘ └──────────────────────┘ │
└─────────────────────────────┼───────────────────────────────────┘
│ Firefox RDP (port 6100)
▼
┌─────────────────────────────────────────────────────────────────┐
│ Zotero Application │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ MCP Bridge for Zotero │ │
│ │ Starts DevToolsServer on launch │ │
│ └──────────────────────────────────────────────────────────┘ │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ Firefox DevTools Server (built-in) │ │
│ │ JS Execution • DOM • Console • Screenshots │ │
│ └──────────────────────────────────────────────────────────┘ │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ Your Plugin (dev) │ │
│ └──────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
Why this approach?
- ✅ Lightweight plugin — Just enables RDP, Firefox DevTools does the rest
- ✅ Zero-config after install — Just open Zotero normally, no special flags
- ✅ Rich AI context — Screenshots, DOM, and logs help the AI understand your plugin's state
- ✅ Hot reload — Integrates with zotero-plugin-scaffold for instant feedback
- ✅ Full Zotero access — Execute any Zotero API in the privileged context
- ✅ Cross-platform — Works on Linux, Windows, macOS
🔧 Environment Variables
| Variable | Description | Default |
|----------|-------------|---------|
| ZOTERO_RDP_PORT | Remote debugging port | 6100 |
| ZOTERO_RDP_HOST | Debugging host | 127.0.0.1 |
| ZOTERO_DATA_DIR | Path to Zotero data directory | Auto-detect |
| ZOTERO_PROFILE_PATH | Path to Zotero profile | Auto-detect |
🔌 Changing the RDP Port
The bridge listens on port 6100 by default. You only need to change it if you run two Zotero instances at the same time (a normal profile and a development one, say), or if another process already holds 6100.
The port lives on both sides of the bridge, and both have to agree on it.
1. Zotero side — set the plugin preference:
- Settings → Advanced → Config Editor, and accept the warning
- Search for
extensions.mcp-rdp.port - If it doesn't exist, create it: select Number, name it
extensions.mcp-rdp.port, and enter your port - Restart Zotero — the listener only opens at startup
Watch the type. The Config Editor pre-selects Boolean. Creating the preference without switching to Number stores
trueinstead of a port, and Zotero then opens the bridge on a local pipe rather than a TCP port
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
120.0kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
114.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
hyperframes
88.2kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.3k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
