SkillAgentSearch skills...

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-dev

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

87/100

Supported Platforms

Claude Code
Claude Desktop

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.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
7/20
Freshness
15/15

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 found

Our 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.

SkillScoreStarsUpdatedFormat
mcp-server-zotero-dev (this skill)by introfini87437d agoMCP Server
taste-skillby Leonxlnx100120.0ktodayCLAUDE.md
Agent-Reachby Panniantong100114.0ktodayCLAUDE.md
hyperframesby heygen-com10088.2ktodayCLAUDE.md
rufloby ruvnet10082.3ktodayCLAUDE.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.
<div align="center">

MCP Server Zotero Dev

Give your AI assistant superpowers for Zotero plugin development

License: MIT Zotero 7+

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

<details> <summary><strong>Claude Code</strong></summary>
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 whatever npx cached and won't pick up new releases, so always include a version and -y (without -y, npx hangs waiting for an install prompt). Bump the pinned version to upgrade, or use @latest to 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 that install-mcp may write a config without -y or 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:

  1. In Zotero: Tools → Plugins
  2. Click ⚙️ → Install Plugin From File
  3. Select the downloaded .xpi file
  4. 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 |

Screenshot Targets: Main window, preferences, PDF reader, dialogs, or any element by selector. Use highlightSelector to add a red border before capture.

</details> <details> <summary><strong>UI Interaction</strong> — Click and type in the Zotero UI</summary>

| 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. |

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.

</details> <details> <summary><strong>JavaScript Execution</strong> — Run code in Zotero context</summary>

| 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 |

Examples: Zotero.Items.getAll(1), Zotero.Prefs.get('export.quickCopy.setting'), ZoteroPane.getSelectedItems()

Tip: Use zotero_inspect_object to explore APIs before writing code. Use zotero_search_prefs to discover preference keys.

</details> <details> <summary><strong>Build & Scaffold</strong> — Integration with zotero-plugin-scaffold</summary>

| 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 |

</details> <details> <summary><strong>Logs & Debugging</strong> — Error console and debug output</summary>

| 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 |

</details> <details> <summary><strong>Plugin Management</strong> — Install, reload, inspect</summary>

| 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 |

</details> <details> <summary><strong>Database Access</strong> — Read-only SQLite access</summary>

| 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) |

Note: Database access is read-only and requires Zotero to be closed, or uses a copy of the database.

</details>

🏗️ 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:

  1. Settings → Advanced → Config Editor, and accept the warning
  2. Search for extensions.mcp-rdp.port
  3. If it doesn't exist, create it: select Number, name it extensions.mcp-rdp.port, and enter your port
  4. 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 true instead 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

View on GitHub
GitHub Stars43
CategoryDevelopment
Updated7d ago
Forks8

Languages

TypeScript

Trust signals

97/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 info