EndNote Library Connector

Pesquise, cite e leia PDFs da sua biblioteca de referências do EndNote diretamente no Claude Desktop.

Documentação

EndNote MCP

Conecte sua biblioteca de referências do EndNote ao Claude AI. Pesquise referências, leia PDFs, formate citações, encontre artigos relacionados e gere bibliografias — tudo diretamente nas conversas do Claude Desktop.

O Que Ele Faz

Depois de configurado, você pode pedir ao Claude coisas como:

"Pesquise em minha biblioteca por capital social e Bourdieu"
"Encontre artigos sobre como organizações lidam com incerteza" (busca semântica)
"Encontre referências relacionadas ao artigo #3844"
"Me dê a citação APA para a referência #1234"
"Gere uma bibliografia para as referências 12, 45, 78, 102"
"Exporte as referências 12, 45, 78 como BibTeX"
"Leia as páginas 5-7 daquele artigo do Smith et al."

O Claude pesquisa sua biblioteca local — nada é enviado para a nuvem além da conversa normal.

Como Funciona

EndNote Library → XML Export → endnote-mcp index → SQLite Database (FTS5 + Embeddings)
                                                          ↕
                                   Claude Desktop ← MCP Server (12 tools)

Suas referências e textos de PDF são indexados em um banco de dados SQLite local com busca em texto completo. Opcionalmente, embeddings de IA permitem busca semântica — encontrando artigos por significado, não apenas por palavras-chave. Quando as dependências semânticas estão instaladas, novas referências são automaticamente incorporadas durante a indexação. O Claude se conecta através do Model Context Protocol (MCP).

Requisitos

EndNote 20+ (qualquer edição)
Aplicativo Claude Desktop

O instalador em pacote abaixo não tem outros pré-requisitos — o Claude Desktop gerencia Python e dependências. O caminho de instalação via CLI adicionalmente precisa de Python 3.10+ e uv (ou pip).

Instalação (Pacote Desktop — Recomendado)

A instalação mais rápida para não-engenheiros. Sem necessidade de Python ou terminal.

Exporte sua biblioteca do EndNote. Arquivo → Exportar → escolha o formato XML → salve em algum lugar como a Área de Trabalho.
Baixe endnote-mcp.mcpb da última versão.
Clique duas vezes no arquivo .mcpb (ou no Claude Desktop: Configurações → Extensões → Instalar Extensão…).
Na janela de instalação, aponte o Claude Desktop para:
- Seu arquivo XML do EndNote (do passo 1)
- Sua Pasta de Anexos PDF — geralmente <library>.Data/PDF/ ao lado do seu arquivo .enl, ou PDF/ dentro de um pacote .enlp.
Clique em Instalar. O Claude Desktop começará a indexar sua biblioteca automaticamente — os metadados ficam pesquisáveis em segundos, o texto dos PDFs e os embeddings semânticos terminam em segundo plano.

É isso. Tente pedir ao Claude "Pesquise em minha biblioteca por grounded theory".

O pacote mantém sua própria configuração (config-mcpb.yaml), então instalá-lo não interferirá em uma configuração CLI existente. Ambos usam o mesmo banco de dados por padrão, então se você já indexou com o CLI, o pacote reutiliza esse índice em vez de criar uma segunda cópia.

Construindo o pacote você mesmo

Mantenedores (ou qualquer pessoa trabalhando a partir do código-fonte) podem construí-lo com:

bash scripts/build_mcpb.sh
# → dist/endnote-mcp.mcpb

A construção é um único arquivo .mcpb multiplataforma (~36 KB). As dependências são resolvidas no momento da instalação via runtime uv incluído no Claude Desktop.

O formato era chamado DXT e usava a extensão .dxt até ser renomeado upstream para MCPB (MCP Bundles). Veja modelcontextprotocol/mcpb.

Instalação (CLI / via PyPI)

Prefere o terminal? Este caminho oferece o CLI endnote-mcp para indexação e embeddings.

1. Instalar

# With uv (recommended)
uv tool install endnote-mcp

# Or with pip
pip install endnote-mcp

2. Exporte sua biblioteca do EndNote

No EndNote: Arquivo → Exportar → escolha o formato XML → salve em um local conveniente (ex.: Área de Trabalho).

3. Execute o assistente de configuração

endnote-mcp setup

O assistente irá:

Detectar automaticamente sua exportação XML e o diretório de PDFs
Criar a configuração
Indexar sua biblioteca
Configurar o Claude Desktop automaticamente

4. Reinicie o Claude Desktop

Feche e reabra o Claude Desktop. Você verá "EndNote Library" nos seus conectores MCP.

Busca Semântica (Opcional)

Habilite a busca baseada em significado que encontra referências mesmo quando elas usam terminologia diferente da sua consulta. Por exemplo, pesquisar "como empresas se preparam para futuros incertos" encontra artigos sobre planejamento de cenários e foresight estratégico.

# Install semantic search dependencies
pip install endnote-mcp[semantic]

# Generate embeddings (~3 min for 4,000 references)
endnote-mcp embed

Isso usa o modelo leve all-MiniLM-L6-v2 localmente — sem necessidade de chaves de API, tudo permanece na sua máquina.

Comandos

Comando	O Que Faz
`endnote-mcp setup`	Assistente de configuração interativo
`endnote-mcp index`	Reindexar após adicionar novas referências (incremental)
`endnote-mcp index --full`	Reindexação completa do zero
`endnote-mcp index --skip-pdfs`	Indexar apenas metadados (rápido, ~1 segundo)
`endnote-mcp index --embed`	Reindexar e gerar embeddings
`endnote-mcp embed`	Gerar embeddings de busca semântica
`endnote-mcp embed --full`	Regenerar todos os embeddings do zero
`endnote-mcp status`	Mostrar estatísticas do índice
`endnote-mcp install`	Adicionar à configuração do Claude Desktop
`endnote-mcp serve`	Iniciar servidor MCP (usado automaticamente pelo Claude Desktop)

Ferramentas Disponíveis para o Claude

Ferramenta	Descrição
`search_references`	Pesquisar por autor, título, ano, palavras-chave, resumo (classificação BM25, com links DOI)
`search_fulltext`	Pesquisar dentro do conteúdo de PDFs — encontrar conceitos, citações, métodos
`search_library`	Busca combinada de metadados + PDF em uma única chamada
`search_semantic`	Pesquisar por significado usando embeddings de IA (requer `endnote-mcp[semantic]`)
`get_reference_details`	Metadados completos de uma referência (resumo, palavras-chave, DOI, etc.)
`get_citation`	Formatar como APA 7ª ed., Harvard, Vancouver, Chicago ou IEEE
`get_bibtex`	Exportar referências como entradas BibTeX para LaTeX
`get_bibliography`	Gerar uma bibliografia formatada para múltiplas referências
`find_related`	Encontrar referências semelhantes (usa embeddings quando disponíveis)
`read_pdf_section`	Ler páginas específicas de um anexo PDF
`list_references_by_topic`	Listagem ampla baseada em tópicos
`rebuild_index`	Reindexar após atualizar sua biblioteca do EndNote

Adicionando Novas Referências

Quando você adiciona novas referências à sua biblioteca do EndNote:

Reexporte o XML do EndNote (sobrescreva o mesmo arquivo)
Ou:
- Execute endnote-mcp index a partir de um terminal, ou
- Peça ao Claude: "Reconstrua o índice da minha biblioteca"

A indexação é incremental — ela processa apenas novas referências e PDFs, não a biblioteca inteira novamente. Se a busca semântica estiver instalada, novas referências são automaticamente incorporadas.

Desempenho

Operação	Tempo (4.000 referências)
Indexação de metadados	~1 segundo
Extração de PDF (primeira vez)	~1 minuto por 100 PDFs
Extração de PDF (incremental)	Apenas novos PDFs
Geração de embeddings	~3 minutos
Busca por palavras-chave	< 50 ms
Busca semântica	< 200 ms

Configuração

A configuração é armazenada em:

macOS: ~/Library/Application Support/endnote-mcp/config.yaml
Windows: %APPDATA%/endnote-mcp/config.yaml
Linux: ~/.config/endnote-mcp/config.yaml

endnote_xml: /path/to/your/library.xml
pdf_dir: /path/to/your/Library.Data/PDF
db_path: /path/to/library.db    # auto-set by setup
max_pdf_pages: 30                # max pages per read request
search_notes: false              # include the EndNote Notes field in searches

Campos de Notas

As Research Notes do EndNote — onde você mantém seus próprios resumos e avaliações — são indexadas e pesquisadas por padrão, classificadas logo abaixo das palavras-chave e acima do resumo.

O campo Notes simples é indexado, mas excluído da correspondência, porque os gerenciadores de referência o usam como depósito na importação: afiliações de autores, endereços de e-mail, termos de tesauro. Defina search_notes: true para incluí-lo. A configuração tem efeito imediato — sem necessidade de reindexação.

Estilos de Citação

Cinco estilos integrados:

APA 7ª ed. — get_citation(rec_number=42, style="apa7")
Harvard — style="harvard"
Vancouver — style="vancouver"
Chicago (Autor-Data, 17ª ed.) — style="chicago"
IEEE — style="ieee"

Use get_bibliography para formatar múltiplas referências de uma vez, ordenadas por autor ou ano.

Exportação BibTeX

Exporte referências como entradas BibTeX para uso em LaTeX:

Peça ao Claude: "Exporte as referências 42 e 100 como BibTeX"
Ou use a ferramenta get_bibtex diretamente com números de registro separados por vírgula

Gera entradas completas com tipos de entrada adequados (@article, @book, @inproceedings, etc.), chaves de citação e todos os campos disponíveis.

Solução de Problemas

"Nenhuma configuração encontrada" — Execute endnote-mcp setup

"Arquivo XML não encontrado" — Reexporte do EndNote: Arquivo → Exportar → formato XML

"PDF não encontrado" — Verifique se pdf_dir na sua configuração aponta para o diretório .Data/PDF correto

A busca não retorna resultados — Execute endnote-mcp index para reconstruir o banco de dados

O Claude Desktop não mostra a ferramenta — Execute endnote-mcp install e reinicie o Claude Desktop

"A busca semântica não está disponível" — Execute pip install endnote-mcp[semantic] e depois endnote-mcp embed

O cliente relata que o servidor "falhou ao conectar" / CONNECTION_CLOSED — O cliente oculta o erro subjacente. Execute echo '' | endnote-mcp serve para ver o traceback real (o erro de decodificação JSON que ele imprime depois é apenas a entrada vazia, não uma falha).

Lançamento

A publicação ocorre em push de tag via .github/workflows/release.yml, que envia para o PyPI e o Registro MCP usando OIDC — nenhum token de API é armazenado no repositório.

A versão existe em sete lugares, e o registro rejeita um server.json que não corresponda exatamente à versão publicada no PyPI. Atualize todos eles e verifique antes de criar a tag:

# pyproject.toml, server.json (x2), CITATION.cff, the README citation
# block, mcpb/manifest.json and mcpb/pyproject.toml
python scripts/check_version.py v1.4.12

git commit -am "Bump version to 1.4.12"
git tag v1.4.12 && git push origin main --tags

Como Citar Este Software

Se você usar esta ferramenta em sua pesquisa, por favor cite-a:

Gokmen, G. (2026). EndNote MCP: Connecting EndNote Reference Libraries to Claude AI (Versão 1.4.12) [Software de computador]. https://doi.org/10.5281/zenodo.18617546

Ou use o botão "Cite this repository" no GitHub para formatos BibTeX/APA.

Licença

AGPL-3.0 — livre para usar, modificar e distribuir. Veja LICENSE para detalhes.