How peterdresslar/zotero-gemini-notebook works
Zotero Gemini Notebook stages selected Zotero attachments, serves only staged files over a local bridge, and uses a Chrome extension to hand them to Gemini Notebook. The optional MCP interface can stage jobs and report their status; it does not perform the browser upload. The graph preserves the documented browse, upload, Studio-prompt, and MCP-configuration capabilities. Some extension internals are unsampled, so only documented high-level links are shown for them.
Main entry points: server.ts Zotero HTTP bridge · dialog.ts Collection browser · stagingAction.ts Quick staging action · popup.js Import popup
Components 25
Zotero plugin
- Collection browser
src/modules/dialog.ts - Collection access
src/modules/collections.ts - Item discovery
src/modules/items.ts - Quick staging action
src/modules/stagingAction.ts
Local bridge
- Human staging
src/modules/staging.ts - Bridge job store
src/modules/bridgeJobStore.js - Zotero HTTP bridge
src/modules/server.ts - Agent job API
src/modules/bridgeJobs.ts - Chrome job events
src/modules/chromeJobEventServer.ts
Chrome handoff
- Chrome extension
chrome-extension/background.js - Import popup
chrome-extension/popup.js - Bridge requests
chrome-extension/bridge-requests.js - Upload handoff
chrome-extension/upload-handoff.js - Page injector
chrome-extension/injector.js - Upload lifecycle
chrome-extension/job-lifecycle.js
MCP interface
- MCP stdio adapter
mcp-adapter/server.py - MCP job tools
mcp-adapter/zotero_jobs.py - MCP status tool
mcp-adapter/zotero_status.py - MCP control server
src/modules/mcpControlServer.ts - Local authorization
src/modules/mcpLocalAuth.ts - MCP setup dialog
src/modules/mcpConfigDialog.ts - Client auto-config
src/modules/mcpClientAutoConfig.js
External services
- Gemini Notebook
- AI client
Other components
- Zotero user
Connections 28
- Zotero user → Collection browser: browses sources
- Collection browser → Collection access: loads collections
src/modules/dialog.ts - Collection browser → Item discovery: finds items
src/modules/dialog.ts - Collection browser → Quick staging action: stages selection
src/modules/dialog.ts - Zotero user → Quick staging action: exports selection
- Quick staging action → Item discovery: resolves attachments
src/modules/stagingAction.ts - Quick staging action → Human staging: stages files
src/modules/stagingAction.ts - Human staging → Bridge job store: activates job
src/modules/staging.ts - Zotero HTTP bridge → Human staging: reads staged state
src/modules/server.ts - Zotero HTTP bridge → Bridge job store: claims staged job
src/modules/server.ts - Zotero HTTP bridge → Chrome extension: serves staged files
- Chrome extension → Import popup: opens import UI
- Import popup → Bridge requests: requests bridge data
chrome-extension/popup.js - Import popup → Upload handoff: starts handoff
chrome-extension/popup.js - Upload handoff → Page injector: coordinates page upload
- Page injector → Gemini Notebook: uploads sources
- Upload lifecycle → Chrome job events: reports job events
- AI client → MCP stdio adapter: calls MCP tools
- MCP stdio adapter → MCP job tools: registers job tools
mcp-adapter/server.py - MCP stdio adapter → MCP status tool: registers status tool
mcp-adapter/server.py - MCP job tools → Zotero HTTP bridge: sends authenticated requests
- MCP status tool → Zotero HTTP bridge: checks bridge status
- MCP control server → Agent job API: creates and reads jobs
src/modules/mcpControlServer.ts - Agent job API → Bridge job store: stores agent jobs
src/modules/bridgeJobs.ts - MCP control server → Local authorization: checks local authorization
src/modules/mcpControlServer.ts - Zotero user → MCP setup dialog: configures MCP
- MCP setup dialog → Client auto-config: plans client setup
src/modules/mcpConfigDialog.ts - Client auto-config → AI client: configures launch