EndNote Library Connector

Busca, cita y lee PDFs de tu biblioteca de referencias de EndNote directamente en Claude Desktop.

Documentación

EndNote MCP

Conecta tu biblioteca de referencias de EndNote a Claude AI. Busca referencias, lee PDFs, formatea citas, encuentra artículos relacionados y genera bibliografías, todo directamente en las conversaciones de Claude Desktop.

Qué Hace

Una vez configurado, puedes pedirle a Claude cosas como:

"Busca en mi biblioteca capital social y Bourdieu"
"Encuentra artículos sobre cómo las organizaciones manejan la incertidumbre" (búsqueda semántica)
"Encuentra referencias relacionadas con el artículo #3844"
"Dame la cita APA para la referencia #1234"
"Genera una bibliografía para las referencias 12, 45, 78, 102"
"Exporta las referencias 12, 45, 78 como BibTeX"
"Lee las páginas 5-7 de ese artículo de Smith et al."

Claude busca en tu biblioteca local — nada se sube a la nube más allá de la conversación normal.

Cómo Funciona

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

Tus referencias y el texto de los PDFs se indexan en una base de datos SQLite local con búsqueda de texto completo. Opcionalmente, los embeddings de IA permiten la búsqueda semántica — encontrar artículos por significado, no solo por palabras clave. Cuando las dependencias semánticas están instaladas, las nuevas referencias se incrustan automáticamente durante la indexación. Claude se conecta a través del Protocolo de Contexto de Modelo (MCP).

Requisitos

EndNote 20+ (cualquier edición)
Aplicación Claude Desktop

El instalador de paquete a continuación no tiene otros requisitos previos — Claude Desktop gestiona Python y las dependencias. La ruta de instalación CLI adicionalmente necesita Python 3.10+ y uv (o pip).

Instalación (Paquete de Escritorio — Recomendado)

La instalación más rápida para no ingenieros. No se requiere Python ni terminal.

Exporta tu biblioteca desde EndNote. Archivo → Exportar → elige formato XML → guarda en algún lugar como el Escritorio.
Descarga endnote-mcp.mcpb desde la última versión.
Haz doble clic en el archivo .mcpb (o en Claude Desktop: Configuración → Extensiones → Instalar Extensión…).
En el diálogo de instalación, apunta Claude Desktop a:
- Tu archivo XML de EndNote (del paso 1)
- Tu Carpeta de Adjuntos PDF — usualmente <library>.Data/PDF/ junto a tu archivo .enl, o PDF/ dentro de un paquete .enlp.
Haz clic en Instalar. Claude Desktop comenzará a indexar tu biblioteca automáticamente — los metadatos son buscables en segundos, el texto de los PDFs y los embeddings semánticos terminan en segundo plano.

Eso es todo. Prueba pedirle a Claude "Busca en mi biblioteca teoría fundamentada".

El paquete mantiene su propia configuración (config-mcpb.yaml), por lo que instalarlo no alterará una configuración CLI existente. Ambos usan la misma base de datos por defecto, así que si ya indexaste con la CLI, el paquete reutiliza ese índice en lugar de construir una segunda copia.

Construyendo el paquete tú mismo

Los mantenedores (o cualquier persona que trabaje desde el código fuente) pueden construirlo con:

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

La compilación es un único archivo .mcpb multiplataforma (~36 KB). Las dependencias se resuelven en el momento de la instalación a través del runtime uv incluido con Claude Desktop.

El formato se llamaba DXT y usaba la extensión .dxt hasta que se renombró upstream a MCPB (MCP Bundles). Ver modelcontextprotocol/mcpb.

Instalación (CLI / desde PyPI)

¿Prefieres la terminal? Esta ruta te da el CLI endnote-mcp para indexar e incrustar.

1. Instalar

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

# Or with pip
pip install endnote-mcp

2. Exporta tu biblioteca desde EndNote

En EndNote: Archivo → Exportar → elige formato XML → guarda en una ubicación conveniente (por ejemplo, Escritorio).

3. Ejecuta el asistente de configuración

endnote-mcp setup

El asistente:

Detectará automáticamente tu exportación XML y el directorio de PDFs
Creará la configuración
Indexará tu biblioteca
Configurará Claude Desktop automáticamente

4. Reinicia Claude Desktop

Cierra y vuelve a abrir Claude Desktop. Verás "EndNote Library" en tus conectores MCP.

Búsqueda Semántica (Opcional)

Habilita la búsqueda basada en significado que encuentra referencias incluso cuando usan terminología diferente a tu consulta. Por ejemplo, buscar "cómo las empresas se preparan para futuros inciertos" encuentra artículos sobre planificación de escenarios y previsión estratégica.

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

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

Esto utiliza el modelo ligero all-MiniLM-L6-v2 localmente — no se necesitan claves API, todo permanece en tu máquina.

Comandos

Comando	Qué Hace
`endnote-mcp setup`	Asistente de configuración interactivo
`endnote-mcp index`	Re-indexar después de añadir nuevas referencias (incremental)
`endnote-mcp index --full`	Re-indexación completa desde cero
`endnote-mcp index --skip-pdfs`	Indexar solo metadatos (rápido, ~1 seg)
`endnote-mcp index --embed`	Re-indexar y generar embeddings
`endnote-mcp embed`	Generar embeddings de búsqueda semántica
`endnote-mcp embed --full`	Regenerar todos los embeddings desde cero
`endnote-mcp status`	Mostrar estadísticas del índice
`endnote-mcp install`	Añadir a la configuración de Claude Desktop
`endnote-mcp serve`	Iniciar servidor MCP (usado automáticamente por Claude Desktop)

Herramientas Disponibles para Claude

Herramienta	Descripción
`search_references`	Buscar por autor, título, año, palabras clave, resumen (clasificado por BM25, con enlaces DOI)
`search_fulltext`	Buscar dentro del contenido de PDFs — encontrar conceptos, citas, métodos
`search_library`	Búsqueda combinada de metadatos + PDF en una sola llamada
`search_semantic`	Buscar por significado usando embeddings de IA (requiere `endnote-mcp[semantic]`)
`get_reference_details`	Metadatos completos de una referencia (resumen, palabras clave, DOI, etc.)
`get_citation`	Formatear como APA 7ª ed., Harvard, Vancouver, Chicago o IEEE
`get_bibtex`	Exportar referencias como entradas BibTeX para LaTeX
`get_bibliography`	Generar una bibliografía formateada para múltiples referencias
`find_related`	Encontrar referencias similares (usa embeddings cuando están disponibles)
`read_pdf_section`	Leer páginas específicas de un PDF adjunto
`list_references_by_topic`	Listado amplio basado en temas
`rebuild_index`	Re-indexar después de actualizar tu biblioteca de EndNote

Añadir Nuevas Referencias

Cuando añades nuevas referencias a tu biblioteca de EndNote:

Re-exporta el XML desde EndNote (sobrescribe el mismo archivo)
O bien:
- Ejecuta endnote-mcp index desde una terminal, o
- Pide a Claude: "Reconstruye mi índice de biblioteca"

La indexación es incremental — solo procesa nuevas referencias y PDFs, no toda la biblioteca nuevamente. Si la búsqueda semántica está instalada, las nuevas referencias se incrustan automáticamente.

Rendimiento

Operación	Tiempo (4,000 referencias)
Indexación de metadatos	~1 segundo
Extracción de PDFs (primera vez)	~1 min por 100 PDFs
Extracción de PDFs (incremental)	Solo PDFs nuevos
Generación de embeddings	~3 minutos
Búsqueda por palabras clave	< 50 ms
Búsqueda semántica	< 200 ms

Configuración

La configuración se almacena en:

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

Las Notas de Investigación de EndNote — donde guardas tus propios resúmenes y juicios — se indexan y buscan por defecto, clasificadas justo debajo de las palabras clave y por encima del resumen.

El campo Notas simple se indexa pero se excluye de la coincidencia, porque los gestores de referencias lo usan como vertedero al importar: afiliaciones de autores, direcciones de correo electrónico, términos de tesauros. Establece search_notes: true para incluirlo. El ajuste tiene efecto inmediato — no se necesita re-indexar.

Estilos de Cita

Cinco estilos integrados:

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

Usa get_bibliography para formatear múltiples referencias a la vez, ordenadas por autor o año.

Exportación BibTeX

Exporta referencias como entradas BibTeX para usar en LaTeX:

Pide a Claude: "Exporta las referencias 42 y 100 como BibTeX"
O usa la herramienta get_bibtex directamente con números de registro separados por comas

Genera entradas completas con tipos de entrada adecuados (@article, @book, @inproceedings, etc.), claves de cita y todos los campos disponibles.

Solución de Problemas

"No se encontró configuración" — Ejecuta endnote-mcp setup

"Archivo XML no encontrado" — Re-exporta desde EndNote: Archivo → Exportar → formato XML

"PDF no encontrado" — Verifica que pdf_dir en tu configuración apunte al directorio .Data/PDF correcto

La búsqueda no devuelve resultados — Ejecuta endnote-mcp index para reconstruir la base de datos

Claude Desktop no muestra la herramienta — Ejecuta endnote-mcp install, luego reinicia Claude Desktop

"La búsqueda semántica no está disponible" — Ejecuta pip install endnote-mcp[semantic] y luego endnote-mcp embed

El cliente informa que el servidor "no pudo conectarse" / CONNECTION_CLOSED — El cliente oculta el error subyacente. Ejecuta echo '' | endnote-mcp serve para ver el traceback real (el error de decodificación JSON que imprime después es solo la entrada vacía, no una falla).

Publicación

La publicación se ejecuta al enviar una etiqueta a través de .github/workflows/release.yml, que sube a PyPI y al Registro MCP usando OIDC — no se almacenan tokens API en el repositorio.

La versión vive en siete lugares, y el registro rechaza un server.json que no coincida exactamente con la versión publicada en PyPI. Actualiza todos, luego verifica antes de etiquetar:

# 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

Citar Este Software

Si usas esta herramienta en tu investigación, por favor cítala:

Gokmen, G. (2026). EndNote MCP: Conectando Bibliotecas de Referencias de EndNote a Claude AI (Versión 1.4.12) [Software de computadora]. https://doi.org/10.5281/zenodo.18617546

O usa el botón "Cite this repository" en GitHub para formatos BibTeX/APA.

Licencia

AGPL-3.0 — libre de usar, modificar y distribuir. Ver LICENCIA para detalles.