O que é Zotero MCP?
O Zotero MCP, de Steven Yu (54yyyu no GitHub), conecta uma biblioteca de pesquisa do Zotero ao Claude, ChatGPT, Cursor e outros clientes MCP. É o projeto de Zotero MCP com mais estrelas, cerca de 5.500 no GitHub, e a versão 0.15.1 saiu no PyPI em 16 de outubro de 2026. Ele está listado no registro oficial do MCP como io.github.54yyyu/zotero-mcp.
O perfil padrão expõe 41 ferramentas, 53 com todos os grupos opcionais ativados. Elas cobrem busca por título, autor, tag, texto completo ou significado (busca semântica com embeddings locais, da OpenAI, do Gemini ou do Ollama), leitura de metadados, BibTeX e intervalos de páginas de PDF, criação de destaques e notas em PDFs, e adição de artigos por DOI, URL, ISBN ou BibTeX. Grupos opcionais acrescentam fusão de duplicatas, contagens de citações do Scite, descoberta pelo OpenAlex e feeds RSS.
O mesmo pacote, zotero-mcp-server, também traz uma zotero-cli com uma skill de agente para agentes de programação que têm shell, e um plugin de chat que roda dentro do Zotero. No modo local, ele lê direto do banco de dados do Zotero; as escritas passam pela API local do Zotero 10 ou pela API web do Zotero.
Como instalar Zotero MCP
uv tool install zotero-mcp-server && zotero-mcp setupZotero MCP vale a pena?
O Zotero MCP transforma uma biblioteca de pesquisa curada em algo que um assistente pode buscar por significado, ler página por página e anotar no lugar, com citações que apontam de volta para o PDF. A busca geral na web não consegue fazer isso, porque não sabe em quais artigos você confia. O modo local lê direto do arquivo zotero.sqlite do Zotero e não exige credenciais, então uma primeira consulta é possível poucos minutos após a instalação.
O projeto é incomumente honesto sobre seu peso. O README mede o perfil padrão de 41 ferramentas em 16.815 tokens a cada requisição, e as 53 ferramentas em 20.942, contra 98 tokens para o caminho da skill de agente até ela ser acionada. Os toolsets ajudam: ZOTERO_MCP_TOOLSETS=none reduz o servidor às ferramentas centrais, e uma ferramenta desativada fica de fato ausente, e não apenas oculta. Em clientes com shell, a skill zotero-cli faz o mesmo trabalho por uma fração do contexto.
As escritas merecem mais cautela do que as leituras. No Zotero 10, uma etapa única de authorize-local permite que o modelo adicione itens, edite metadados, mova itens entre coleções, apague anotações de forma permanente e, com o grupo de duplicatas ativado, funda itens após uma etapa de planejar e confirmar. Em versões mais antigas do Zotero, as escritas passam pela API web com uma chave. O caminho do ChatGPT é o ponto mais fraco: zotero-mcp serve não tem autenticação, então a receita com ngrok da documentação transforma a URL do túnel em um bearer token, e uma issue aberta (#616) pede uma opção de autenticação adequada.
É um projeto da comunidade financiado pelo GitHub Sponsors, não algo que a equipe do Zotero lança, e isso tem dois lados. As versões chegam toda semana (0.14.1 em 8 de outubro, depois 0.15.0 e 0.15.1 com um dia de intervalo), e as 63 issues e pull requests abertos incluem casos-limite reais, como uploads de bibliotecas de grupo indo parar no armazenamento WebDAV pessoal. A API web do Zotero pede que os clientes se limitem a quatro requisições simultâneas e respeitem os headers Backoff, uma regra que importa muito mais para um agente que adora lotes do que para uma pessoa clicando.
Onde ele se destaca
Uma doutoranda com cerca de 1.800 artigos no Zotero 10, trabalhando no Claude Desktop
Descobrir o que minha biblioteca diz sobre um método e citar a página exata
A busca semântica com o modelo local gratuito all-MiniLM-L6-v2 encontra artigos por significado, zotero_read_pdf_pages puxa as páginas relevantes e zotero_create_annotation destaca o trecho. Nada a pagar além da assinatura do modelo, mas a lista de ferramentas padrão acrescenta cerca de 17k tokens a cada turno.
Um engenheiro de pesquisa redigindo uma seção de trabalhos relacionados em LaTeX com o Claude Code
Puxar BibTeX e citações de 30 artigos sem sair do editor
Rode zotero-mcp install-skill em vez de adicionar o servidor MCP: a skill custa 98 tokens até ser usada e aciona a zotero-cli para metadados e BibTeX. As leituras são locais, então nada sai da máquina além do que o agente envia ao seu modelo.
Um gerente de laboratório que cuida de uma biblioteca de grupo compartilhada por oito pesquisadores
Limpar duplicatas e arquivar novos artigos nas coleções certas
Ative o grupo de duplicatas e faça o agente rodar zotero_merge_duplicates como simulação antes de confirmar. Escritas pela API web exigem uma chave com permissão de escrita no grupo, e o Zotero pede no máximo quatro requisições simultâneas; uma exportação antes da primeira fusão é um seguro barato.
Antes de decidir
- Configuração
- uv tool install zotero-mcp-server, marque "Allow other applications on this computer to communicate with Zotero" no Zotero 7 ou posterior, depois zotero-mcp setup configura o Claude Desktop; zotero-mcp install-skill cobre Claude Code, Codex e Cursor. A busca semântica exige o extra [semantic] e um índice criado com zotero-mcp update-db.
- Integrações
- 41 ferramentas por padrão e 53 com todos os grupos ativados: busca, metadados, texto completo, páginas e sumários de PDF, anotações e notas, adição por DOI, URL, ISBN ou BibTeX, e coleções, além de Scite, OpenAlex, feeds, relações e duplicatas opcionais. Ferramentas de leitura e escrita ficam juntas no conjunto central.
- Dados e privacidade
- O modo local lê zotero.sqlite diretamente; o texto só sai da máquina para o seu provedor de modelos e, se você escolher, para embeddings da OpenAI ou do Gemini. O modo API web exige uma chave de API do Zotero e o ID da biblioteca. Importações por DOI e URL buscam metadados e PDFs em fontes externas, e o transporte HTTP não tem autenticação. Não há avisos de segurança publicados.
- Custo em escala
- O software é gratuito. A sincronização de arquivos do Zotero custa $20 por ano para 2 GB, $60 para 6 GB ou $120 para ilimitado, se os anexos ficarem no armazenamento do Zotero. O custo maior é o contexto: 16.815 tokens de definições de ferramentas por requisição no perfil padrão, pagos a cada turno, a menos que o cliente os mantenha em cache.
- Limites
- A API web do Zotero limita com headers Backoff e respostas 429 e pede no máximo quatro requisições simultâneas; a API local não tem limite de taxa. Issues abertas incluem a detecção da CLI no Windows no plugin dentro do Zotero e anexos de bibliotecas de grupo sendo enviados para o armazenamento WebDAV pessoal.
O que é bom
- Busca na sua própria biblioteca por significado, com embeddings locais gratuitos por padrão
- Leitura de PDF por página, com destaques colocados nos trechos exatos
- O modo local somente leitura não exige chave de API
- Toolsets e uma skill de CLI de 98 tokens reduzem o custo de contexto
O que não é
- As 41 ferramentas padrão custam 16.815 tokens por requisição
- Ferramentas de escrita podem apagar anotações e fundir itens
- O modo HTTP para o ChatGPT não tem autenticação
- Projeto de um único mantenedor, não do Zotero
Ideal para
Acadêmicos e estudantes que guardam seus artigos no Zotero e querem que um assistente os busque, leia e anote.
Alternativas ao Zotero MCP
Zotero MCP: perguntas frequentes
- Zotero MCP vale a pena?
- Para quem tem suas leituras no Zotero, este é o servidor a usar, embora sua lista de ferramentas de 17.000 tokens torne a skill da CLI o caminho mais inteligente em agentes de programação. Damos nota 4.2 de 5.
- Quanto custa Zotero MCP?
- Gratuito e de código aberto (MIT para o servidor e a CLI; o plugin de chat dentro do Zotero é AGPL-3.0). Provedores de embeddings hospedados cobram por conta própria.
- Quais são as desvantagens de Zotero MCP?
- As 41 ferramentas padrão custam 16.815 tokens por requisição; ferramentas de escrita podem apagar anotações e fundir itens; o modo HTTP para o ChatGPT não tem autenticação; projeto de um único mantenedor, não do Zotero.
- Para quem Zotero MCP é indicado?
- Acadêmicos e estudantes que guardam seus artigos no Zotero e querem que um assistente os busque, leia e anote.
- Quanto custa Zotero MCP para uma equipe ou em produção?
- O software é gratuito. A sincronização de arquivos do Zotero custa $20 por ano para 2 GB, $60 para 6 GB ou $120 para ilimitado, se os anexos ficarem no armazenamento do Zotero. O custo maior é o contexto: 16.815 tokens de definições de ferramentas por requisição no perfil padrão, pagos a cada turno, a menos que o cliente os mantenha em cache.
- Zotero MCP é seguro para dados da empresa?
- O modo local lê zotero.sqlite diretamente; o texto só sai da máquina para o seu provedor de modelos e, se você escolher, para embeddings da OpenAI ou do Gemini. O modo API web exige uma chave de API do Zotero e o ID da biblioteca. Importações por DOI e URL buscam metadados e PDFs em fontes externas, e o transporte HTTP não tem autenticação. Não há avisos de segurança publicados.
- Quais são as melhores alternativas ao Zotero MCP?
- As alternativas mais próximas que analisamos são Notion MCP e Memory (reference server).
Respostas verificadas em 22 de out. de 2026.