zotero-mcp-code

Execute Zotero semantic, keyword, and tag searches with deduplication and ranking.

59|8|Updated Nov 8, 2025
One-click install
npx skills add https://github.com/kerim/zotero-code-execution --skill zotero-mcp-code
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zotero-mcp-code
Source: https://github.com/kerim/zotero-code-execution/tree/main
Command: npx skills add https://github.com/kerim/zotero-code-execution --skill zotero-mcp-code

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Zotero MCP workflow often crashes when returning large results to Claude. This skill executes Zotero queries inside the code execution environment, keeping heavy data out of the LLM context and preventing crashes.

Core Features & Use Cases

  • Multi-strategy search: semantic, keyword, and tag-based queries are combined, deduplicated, and ranked automatically.
  • Safe large-scale data handling: fetch 50-100+ items per strategy without overwhelming the LLM context.
  • Fast, structured results: returns a formatted Markdown list ready for display in Claude or downstream tools.
  • Use Case: a researcher wants a comprehensive literature set on embodied cognition; the skill returns the top 20 most relevant papers after deduplication and ranking.

Quick Start

Quick Start instructions: Import the library, instantiate a SearchOrchestrator, call comprehensive_search('your query', max_results=20), and format the results to display.

Frequently Asked Questions about zotero-mcp-code

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does Zotero MCP crash when returning large search results and how can I prevent it?

The Zotero MCP crashes when heavy data overwhelms the LLM context. You can prevent these crashes by executing Zotero queries inside a code execution environment to keep large datasets out of the context window.

How do I combine semantic and keyword searches in Zotero without duplicates?

To combine semantic and keyword searches without duplicates, use a search orchestrator that runs multi-strategy queries, automatically deduplicates the results, and ranks them by relevance before returning a concise list.

Can I fetch 50 to 100 Zotero items at once without overwhelming Claude's context?

Yes, you can safely fetch 50 to 100 Zotero items by loading the large datasets within a code execution environment, which processes the heavy data and returns only a formatted, concise set to the LLM.

How do I retrieve and rank top research papers from Zotero for literature reviews?

To retrieve and rank top research papers for literature reviews, execute a comprehensive search query that fetches items via multiple strategies, deduplicates the library entries, and ranks them to return the most relevant papers.

Does Zotero MCP support semantic search and tag-based filtering together?

Zotero queries support combining semantic search, keyword matching, and tag-based filtering together. The results are automatically deduplicated and ranked to provide a structured Markdown list for your research.