Zotero MCP — Instalar & Demo ao vivo

Por que usar

Principais recursos

Busca por autor, título, tag, coleção e texto completo
Exportar BibTeX/CSL-JSON para qualquer item
Extrair destaques e anotações de anexos PDF
Compatível com a API local do Zotero 7 e a API Web do Zotero
Somente leitura por padrão — seguro para conectar à sua biblioteca de pesquisa

Demo ao vivo

Como fica na prática

zotero-mcp.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "zotero-mcp": {
      "command": "uvx",
      "args": [
        "zotero-mcp"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "zotero-mcp": {
      "command": "uvx",
      "args": [
        "zotero-mcp"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "zotero-mcp": {
      "command": "uvx",
      "args": [
        "zotero-mcp"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "zotero-mcp": {
      "command": "uvx",
      "args": [
        "zotero-mcp"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "zotero-mcp",
      "command": "uvx",
      "args": [
        "zotero-mcp"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "zotero-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "zotero-mcp"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add zotero-mcp -- uvx zotero-mcp

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Zotero MCP

Sintetizar uma revisão bibliográfica a partir de artigos marcados com tags

👤 Estudantes de pós-graduação e pesquisadores ⏱ ~60 min intermediate

Quando usar: Você marcou 30 artigos com #thesis-ch3 e precisa escrever a seção 3.2.

Pré-requisitos

Zotero rodando (API local habilitada) — Zotero 7: Configurações → Avançado → habilitar API local
Chave de API se usar a web — zotero.org/settings/keys

Fluxo

Carregar o conjunto

Liste todos os itens marcados com thesis-ch3 no meu Zotero. Só títulos + anos + primeiro autor.✓ Copiado

→ Inventário limpo, ~30 itens
Agrupar

Agrupe-os por abordagem metodológica. Cite cada item pela chave do Zotero.✓ Copiado

→ 3–5 grupos com citações por grupo
Extrair + escrever

Para o grupo "RCTs quantitativos", busque meus destaques de cada item e rascunhe um parágrafo de síntese com citações inline.✓ Copiado

→ Parágrafo com citações (Autor, Ano) apoiadas em destaques reais

Resultado: Um rascunho da seção 3.2 para editar, em vez de começar do zero.

Armadilhas

PDF sem destaques, apenas digitalizado — Execute OCR no Zotero primeiro (clique com o botão direito → OCR PDF) e depois busque novamente

Combine com: filesystem

Gerar a bibliografia para um artigo em elaboração

👤 Quem escreve com LaTeX ⏱ ~15 min beginner

Quando usar: Você citou 40 itens ao longo de um rascunho e precisa de um único references.bib.

Fluxo

Varrer as citações

Em /paper/main.tex, liste cada chave \cite{}.✓ Copiado

→ Todas as chaves de citação enumeradas
Resolver

Para cada uma, busque o BibTeX no Zotero e escreva o resultado em /paper/references.bib. Sinalize qualquer chave sem correspondência.✓ Copiado

→ Arquivo bib gerado; citações não resolvidas listadas

Resultado: Um references.bib limpo vinculado ao seu Zotero — sem copia e cola manual.

Armadilhas

Incompatibilidade de chave (Better BibTeX vs. padrão) — Instale a extensão Better BibTeX no Zotero para chaves estáveis e fixadas

Combine com: filesystem

Combinações

Combine com outros MCPs para 10× de alavancagem

zotero-mcp + filesystem

Salvar a síntese extraída no rascunho do artigo

Salve a síntese do Zotero em /paper/section-3-2.md.✓ Copiado

zotero-mcp + memory

Lembrar os argumentos principais de cada artigo entre sessões

Armazene a tese em uma frase de cada item do grupo A na memória.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
search_items	query: str, tag?: str, collection?: str	Encontrar itens na biblioteca	free
get_item	key: str	Inspecionar um item em profundidade	free
get_annotations	key: str	Buscar seus destaques e notas em um PDF	free
get_bibtex	keys: str[]	Montar a bibliografia de um rascunho	free
list_collections	none	Navegar pela sua organização	free

Custo e limites

O que custa rodar

Cota de API: API local: ilimitada. API web: com limite de taxa do Zotero.
Tokens por chamada: Metadados de item ~200 tokens; anotações podem ser grandes
Monetário: Gratuito
Dica: Prefira search_items com filtros de tag a listar todos os itens

Segurança

Permissões, segredos, alcance

Escopos mínimos: library:read

Armazenamento de credenciais: Chave de API em variável de ambiente (somente no modo web)

Saída de dados: api.zotero.org (modo web) ou localhost (modo local)

Nunca conceda: library:write unless truly needed

Solução de problemas

Erros comuns e correções

ECONNREFUSED localhost:23119

O Zotero não está rodando ou a API local está desabilitada. Abra o Zotero; Configurações → Avançado → habilitar API local.

Verificar: `curl http://localhost:23119/api/users/0/items`

API web 403

Chave de API sem o escopo de leitura da biblioteca. Regenere em zotero.org/settings/keys.

Chaves BibTeX são geradas automaticamente sem sentido

Instale o add-on Better BibTeX e defina um formato de chave estável

Alternativas

Zotero MCP vs. outros

Alternativa	Quando usar	Troca
Obsidian MCP	Suas notas estão no Obsidian, não no Zotero	Modelo de dados diferente — não centrado em artigos
Direct Zotero CSL export	Exportação pontual, sem envolvimento de LLM	Sem consultas, sem síntese

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills