# io.github.introfini/mcp-server-zotero-dev (npm · @introfini/mcp-server-zotero-dev)

MCP server enabling AI assistants to build, test, and debug Zotero plugins

- Trust score: 71/100 (medium)
- Change this week: +18
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-04

## Components

- npm · `@introfini/mcp-server-zotero-dev`: 71/100 (this document), [markdown](https://verifymcp.io/servers/introfini-mcp-server-zotero-dev/introfini-mcp-server-zotero-dev.md), [page](https://verifymcp.io/servers/introfini-mcp-server-zotero-dev/introfini-mcp-server-zotero-dev)

## Channel facts

- Registry: `npm`
- Package: `@introfini/mcp-server-zotero-dev`
- Version: `1.1.2`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-04.

- **Supply Chain Security**: 86/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 39 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 85/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 2484 tokens (~88/item across 28 items; 28 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 30/100
  - Stability observed for 9 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add introfini-mcp-server-zotero-dev -- npx -y @introfini/mcp-server-zotero-dev
```

### Codex

```bash
codex mcp add introfini-mcp-server-zotero-dev -- npx -y @introfini/mcp-server-zotero-dev
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "introfini-mcp-server-zotero-dev": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@introfini/mcp-server-zotero-dev"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add introfini-mcp-server-zotero-dev --command npx --arg -y --arg @introfini/mcp-server-zotero-dev
```

### Hermes

```yaml
mcp_servers:
  introfini-mcp-server-zotero-dev:
    command: "npx"
    args: ["-y", "@introfini/mcp-server-zotero-dev"]
```

### Other

```json
{
  "mcpServers": {
    "introfini-mcp-server-zotero-dev": {
      "command": "npx",
      "args": [
        "-y",
        "@introfini/mcp-server-zotero-dev"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-04 (score 71, +4)

- [functional improvement] Stability: unverified → 0.30

### 2026-08-02 (score 67, +62)

- [security regression] Provenance: unverified → fail
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Install scripts: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional regression] Security disclosure: fail → unverified
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] License: unverified → pass
- [functional improvement] Schema quality: unverified → 100
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional] Licence: MIT

### 2026-07-31 (score 5, −1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 6, −47)

- [security regression] Malware scan: pass → unverified
- [functional regression] Schema quality: 100 → unverified
- [functional regression] Tool coverage: 100 → unverified

### 2026-07-27 (score 53)

First indexed and scored.

## MCP tools (28)

### `zotero_ping` (~39 tokens)

Test connection to Zotero and get version info. Use this to verify that Zotero is running and the MCP Bridge for Zotero plugin is active.

### `zotero_execute_js` (~219 tokens)

Execute JavaScript code in Zotero's privileged chrome context. Has full access to Zotero APIs (Zotero.*, ZoteroPane, etc.). Use for testing code snippets, inspecting state, or performing actions. Prefer a dedicated tool when one fits the question (zotero_db_query for library data, zotero_read_logs/zotero_read_errors for output, zotero_inspect_object for API discovery); reach for raw JS only when none does. Code with top-level 'return' statements is auto-wrapped in an IIFE. Tip: For complex objects, use JSON.stringify(obj) to get full data. IMPORTANT: Before calling unknown APIs, use zotero_inspect_object to discover available methods - don't guess API names.

Input parameters:

- `awaitPromise` (boolean): Whether to await the result if it's a Promise (default: true)
- `code` (string, required): JavaScript code to execute. Can be async (automatically awaited). You can use 'return' at top level - code will be auto-wrapped in IIFE.

### `zotero_get_pref` (~49 tokens)

Get a Zotero preference value. Common prefs: extensions.zotero.*, general.*, export.*

Input parameters:

- `key` (string, required): Preference key (e.g., 'extensions.zotero.debug.log')

### `zotero_set_pref` (~50 tokens)

Set a Zotero preference value. Use with caution - some preferences require restart.

Input parameters:

- `key` (string, required): Preference key
- `value` (required): Value to set (string, number, or boolean)

### `zotero_search_prefs` (~129 tokens)

Search and list Zotero/Firefox preferences. Use to discover available preference keys before using zotero_get_pref/zotero_set_pref. Can filter by branch prefix (e.g., 'extensions.zotero.') and/or substring pattern.

Input parameters:

- `branch` (string): Preference branch to list (e.g., 'extensions.zotero.', 'general.'). Defaults to 'extensions.zotero.' if not specified.
- `limit` (number): Maximum number of results to return (default: 50)
- `pattern` (string): Substring filter for preference names (case-insensitive)

### `zotero_inspect_object` (~174 tokens)

Inspect a Zotero/JavaScript object to discover its methods and properties. Use to explore APIs like Zotero.Items, ZoteroPane, Zotero.Prefs without manual JS execution. Returns methods with signatures and properties with their types/values.

Input parameters:

- `depth` (number): Prototype chain depth to inspect (default: 2, max: 5)
- `filter` (string): What to include: 'all' (default), 'methods' only, 'properties' only, or 'own' (only own properties, not inherited)
- `path` (string, required): Object path to inspect (e.g., 'Zotero', 'Zotero.Items', 'ZoteroPane', 'Zotero.Prefs')
- `pattern` (string): Filter member names by substring (case-insensitive)

### `zotero_open_preferences` (~141 tokens)

Open Zotero's preferences/settings window. Optionally navigate directly to a specific pane. For built-in panes, use: 'general', 'sync', 'export', 'cite', 'advanced'. For plugin panes, use the plugin ID (e.g., 'zotseek@zotero.org' or just 'zotseek').

Input parameters:

- `paneId` (string): Optional pane ID to navigate to. Built-in: 'general', 'sync', 'export', 'cite', 'advanced'. For plugins: use the plugin ID (e.g., 'zotseek@zotero.org'). If omitted, opens to the last viewed pane.

### `zotero_screenshot` (~160 tokens)

Capture a screenshot of Zotero. Can capture the main window, a specific window, or a specific element by CSS selector. Optionally highlight an element with a red border.

Input parameters:

- `format` (string): Image format (default: png)
- `highlightSelector` (string): CSS selector for element to highlight with red border before capture
- `scale` (number): Scale factor for the screenshot (default: 1)
- `selector` (string): CSS selector for element to capture (required if target='element')
- `target` (string): What to capture: main-window (default), specific window, or element
- `windowId` (number): Window outerWindowID (use zotero_list_windows to find). Required if target='window'

### `zotero_inspect_element` (~92 tokens)

Find DOM elements by CSS selector and return their details. Returns: tagName, id, className, attributes, text content, bounding rect, child count.

Input parameters:

- `limit` (number): Maximum number of elements to return (default: 10)
- `selector` (string, required): CSS selector to find elements
- `windowId` (number): Window outerWindowID (optional, defaults to main window)

### `zotero_get_dom_tree` (~85 tokens)

Get a simplified DOM tree structure. Shows tag names, IDs, classes, and child counts for navigation.

Input parameters:

- `depth` (number): Maximum depth to traverse (default: 3)
- `selector` (string): CSS selector for root element (default: document.documentElement)
- `windowId` (number): Window outerWindowID (optional, defaults to main window)

### `zotero_get_styles` (~70 tokens)

Get computed CSS styles for an element. Useful for debugging layout and styling issues.

Input parameters:

- `properties` (array): Specific CSS properties to return (default: common layout properties)
- `selector` (string, required): CSS selector for the element
- `windowId` (number): Window outerWindowID (optional)

### `zotero_list_windows` (~37 tokens)

List all open Zotero windows with their IDs, types, and titles. Use the windowId in other tools to target specific windows.

### `zotero_click_element` (~260 tokens)

Click an element in a Zotero window by CSS selector (toolbar/menu button, preference control, list row, etc.). Resolves light DOM first, then pierces open shadow roots (Zotero's XUL custom elements keep internals in shadow DOM). If the selector matches several elements, use index to pick one. By default calls element.click() (which fires the XUL command for buttons/menuitems); set mouseEvents=true to dispatch a synthesized mousedown/mouseup/click sequence for content that needs real mouse events. Cannot dismiss a BLOCKING native modal dialog (Services.prompt.confirmEx) — see the module note.

Input parameters:

- `index` (number): Which match to click when the selector matches several (0-based, default 0)
- `mouseEvents` (boolean): Dispatch synthesized mousedown/mouseup/click instead of element.click() (default false). Use for HTML content that needs real mouse events. Note: these events are untrusted (isTrusted=false); some na…
- `selector` (string, required): CSS selector for the element to click
- `windowId` (number): Window outerWindowID (optional, defaults to main window)

### `zotero_send_keys` (~233 tokens)

Type text into an element in a Zotero window (an input/textarea or any contenteditable). If a selector is given the element is focused first (light DOM, then open shadow roots); otherwise the window's active element is used. Fires input/change events so listeners react. Optionally clear first and/or press Enter afterwards. Note: a few widgets (e.g. Zotero's quick-search) only fully react to their own command handler, not a raw input event — prefer a direct field where possible.

Input parameters:

- `clear` (boolean): Clear the field before typing (default false)
- `pressEnter` (boolean): Dispatch an Enter keydown/keypress/keyup after typing (default false). Note: these events are untrusted (isTrusted=false) and some widgets ignore them — a direct input + change is more reliable where…
- `selector` (string): CSS selector for the target field (optional; defaults to the active element)
- `text` (string, required): Text to type into the element
- `windowId` (number): Window outerWindowID (optional, defaults to main window)

### `zotero_read_logs` (~78 tokens)

Read Zotero's debug log output. Shows recent debug messages from Zotero.debug() calls.

Input parameters:

- `filter` (string): Filter logs containing this string (case-insensitive)
- `level` (string): Filter by log level (default: all)
- `lines` (number): Number of recent lines to return (default: 100)

### `zotero_read_errors` (~48 tokens)

Read errors from Zotero's error console. Returns JavaScript errors with stack traces and source locations.

Input parameters:

- `lines` (number): Number of recent errors to return (default: 20)

### `zotero_clear_logs` (~19 tokens)

Clear the debug log buffer and error console.

### `zotero_watch_logs` (~52 tokens)

Start/stop watching for new log messages. Use action='start' to begin collecting, 'get' to retrieve collected logs, 'stop' to end.

Input parameters:

- `action` (string, required): Action to perform

### `zotero_scaffold_build` (~74 tokens)

Build a Zotero plugin project using zotero-plugin-scaffold. Runs 'npm run build' or 'npm run build:dev' in the project directory.

Input parameters:

- `mode` (string): Build mode (default: development)
- `projectPath` (string): Path to plugin project (default: current working directory)

### `zotero_scaffold_serve` (~68 tokens)

Start/stop the zotero-plugin-scaffold dev server with hot reload. This watches for changes and automatically rebuilds/reloads the plugin.

Input parameters:

- `action` (string, required): Action to perform
- `projectPath` (string): Path to plugin project (default: current working directory)

### `zotero_scaffold_lint` (~54 tokens)

Run ESLint on a Zotero plugin project.

Input parameters:

- `fix` (boolean): Automatically fix problems (default: false)
- `projectPath` (string): Path to plugin project (default: current working directory)

### `zotero_scaffold_typecheck` (~42 tokens)

Run TypeScript type checking on a Zotero plugin project.

Input parameters:

- `projectPath` (string): Path to plugin project (default: current working directory)

### `zotero_plugin_reload` (~69 tokens)

Reload a Zotero plugin. If a plugin ID is provided, reloads that specific plugin. Otherwise attempts to reload based on the current project.

Input parameters:

- `pluginId` (string): Plugin ID to reload (e.g., 'my-plugin@example.com'). Use zotero_plugin_list to find IDs.

### `zotero_plugin_list` (~29 tokens)

List all installed Zotero plugins/add-ons with their IDs, names, versions, and status.

### `zotero_plugin_install` (~51 tokens)

Install a Zotero plugin from a local XPI file. The plugin will be installed and Zotero may need to be restarted.

Input parameters:

- `path` (string, required): Path to the XPI file to install

### `zotero_db_query` (~92 tokens)

Execute a SELECT query on Zotero's database. Only SELECT queries are allowed for safety. Note: Database may be locked if Zotero is running - a copy may be used.

Input parameters:

- `limit` (number): Maximum rows to return (default: 100, max: 1000)
- `params` (array): Query parameters for prepared statements
- `query` (string, required): SQL SELECT query to execute

### `zotero_db_schema` (~48 tokens)

Get database schema information. If table is specified, returns columns for that table. Otherwise returns list of all tables.

Input parameters:

- `table` (string): Table name to get schema for (optional)

### `zotero_db_stats` (~22 tokens)

Get database statistics: item counts, file size, etc.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/introfini-mcp-server-zotero-dev/introfini-mcp-server-zotero-dev#diagnostics

## Score history

- 2026-08-04: 71
- 2026-08-03: 67
- 2026-08-02: 67
- 2026-08-01: 5
- 2026-07-31: 5
- 2026-07-30: 6
- 2026-07-28: 53
- 2026-07-27: 53

## Links

- npm package: https://www.npmjs.com/package/@introfini/mcp-server-zotero-dev
- Socket report: https://socket.dev/npm/package/@introfini/mcp-server-zotero-dev
- Repository: https://github.com/introfini/mcp-server-zotero-dev
- Changelog RSS feed: https://verifymcp.io/servers/introfini-mcp-server-zotero-dev/introfini-mcp-server-zotero-dev/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/introfini-mcp-server-zotero-dev/introfini-mcp-server-zotero-dev/changelog.json
- HTML version of this page: https://verifymcp.io/servers/introfini-mcp-server-zotero-dev/introfini-mcp-server-zotero-dev