Servidor MCP de Bear Notes

Busca, lee, crea y actualiza tus notas de Bear desde cualquier asistente de IA. Disponible como extensión de Claude Desktop de un solo clic y como paquete npm independiente para cualquier cliente MCP.

Este servidor MCP solo local lee la base de datos SQLite de Bear para búsquedas rápidas con soporte OCR, y utiliza la API nativa de Bear para las escrituras. Privacidad total: sin conexiones externas, todo el procesamiento se realiza en tu Mac.

Ejemplos de prompts:

Resume nuestra conversación y crea una nueva nota en Bear con ella

Entrevístame sobre la idea de mi proyecto paralelo y captura los puntos clave en una nota de Bear

Ayúdame a reestructurar el esquema de mi nota "Lanzamiento de producto"

Hagamos una lluvia de ideas para publicaciones de blog: guarda las mejores en mi nota de Bear y refínalas a medida que avanzamos

✨ Características principales

• 13 herramientas MCP para buscar, leer, crear, actualizar, etiquetar y archivar notas

• Búsqueda OCR — encuentra texto dentro de imágenes y archivos PDF adjuntos

• Búsqueda basada en fechas con fechas relativas ("ayer", "la semana pasada", "inicio del mes pasado")

• Gestión de etiquetas — lista las etiquetas como un árbol, encuentra notas sin etiquetas, añade etiquetas a las notas

• Convención de nueva nota (opcional) — coloca las etiquetas justo después del título en lugar de al final

• Reemplazo de contenido (opcional) — reemplaza todo el cuerpo de la nota o una sección específica

• Solo local — sin llamadas de red, todos los datos permanecen en tu Mac

📦 Instalación

Extensión de Claude Desktop

Requisitos previos: Debes tener instalada la aplicación Bear y Claude Desktop.

1. Descarga el archivo de extensión bear-notes-mcpb-*.mcpb más reciente desde Releases

2. Asegúrate de que Claude Desktop esté ejecutándose (inícialo si no lo está)

3. Haz doble clic en el archivo de extensión: Claude Desktop debería mostrarte el aviso de instalación

   Si el doble clic no funciona por alguna razón, abre Claude -> Settings -> Extensions -> Advanced Settings -> haz clic en "Install Extension".

4. ¡LISTO!

Pídele a Claude que busque en tus notas de Bear con una consulta como "Busca en mis notas de Bear 'reunión'" - ¡deberías ver tus notas aparecer en la respuesta!

Servidor MCP independiente

¿Quieres usar este servidor MCP de Bear Notes con Claude Code, Cursor, Codex u otros asistentes de IA?

Requisitos: Node.js 24.13.0+

Claude Code (un comando)

claude mcp add bear-notes --transport stdio -- npx -y bear-notes-mcp@latest

Otros asistentes de IA

Añade a tu archivo de configuración MCP:

{
  "mcpServers": {
    "bear-notes": {
      "command": "npx",
      "args": ["-y", "bear-notes-mcp@latest"]
    }
  }
}

Más opciones de instalación y configuración de desarrollo local — NPM.md

🛠️ Herramientas

• bear-open-note - Lee el contenido de texto completo de una nota de Bear, incluido el texto OCR de imágenes y archivos PDF adjuntos

• bear-create-note - Crea una nueva nota en tu biblioteca de Bear con título, contenido y etiquetas opcionales

• bear-search-notes - Encuentra notas buscando en el contenido de texto, filtrando por etiquetas o rangos de fechas. Incluye búsqueda OCR en archivos adjuntos

• bear-add-text - Inserta texto al principio o al final de una nota de Bear, o dentro de una sección específica identificada por su encabezado

• bear-replace-text - Reemplaza contenido en una nota de Bear existente, ya sea todo el cuerpo o una sección específica. Requiere que el reemplazo de contenido esté habilitado en la configuración.

• bear-add-file - Adjunta un archivo a una nota de Bear existente. Proporciona una ruta de archivo local (preferido) o contenido codificado en base64.

• bear-list-tags - Lista todas las etiquetas en tu biblioteca de Bear como un árbol jerárquico con recuentos de notas

• bear-find-untagged-notes - Encuentra notas en tu biblioteca de Bear que no tienen etiquetas asignadas

• bear-add-tag - Añade una o más etiquetas a una nota de Bear existente

• bear-archive-note - Archiva una nota de Bear para eliminarla de las listas activas sin borrarla

• bear-rename-tag - Cambia el nombre de una etiqueta en todas las notas de tu biblioteca de Bear

• bear-delete-tag - Elimina una etiqueta de todas las notas de tu biblioteca de Bear sin afectar a las notas

• bear-grab-url - Guarda una página web como una nota de Bear. Bear obtiene la página y la convierte a markdown.

⚙️ Configuración

Registro de depuración (Debug Logging)

Habilita el registro detallado para la resolución de problemas.

• Claude Desktop: Settings → Extensions → Configure (junto a Bear Notes) → activa "Debug Logging" → Save → Reinicia Claude

• Servidor MCP independiente: establece la variable de entorno UI_DEBUG_TOGGLE=true

Convención de nueva nota

Por defecto, Bear coloca las etiquetas al final de una nota cuando se crea a través de la API. Habilita esta opción para colocar las etiquetas justo después del título, separadas por una línea horizontal.

┌──────────────────────────────┐
│ # Meeting Notes              │  ← Note title
│ #work #meetings              │  ← Tags right after title
│                              │
│ ---                          │  ← Separator
│                              │
│ Lorem Ipsum...               │  ← Note body
└──────────────────────────────┘

• Claude Desktop: Settings → Extensions → Configure (junto a Bear Notes) → activa "New Note Convention" → Save → Reinicia Claude

• Servidor MCP independiente: establece la variable de entorno UI_ENABLE_NEW_NOTE_CONVENTION=true

Ejemplo de configuración independiente con la convención habilitada:

{
  "mcpServers": {
    "bear-notes": {
      "command": "npx",
      "args": ["-y", "bear-notes-mcp@latest"],
      "env": {
        "UI_ENABLE_NEW_NOTE_CONVENTION": "true"
      }
    }
  }
}

Reemplazo de contenido

Habilita la herramienta bear-replace-text para reemplazar contenido en notas existentes, ya sea todo el cuerpo de la nota o una sección específica bajo un encabezado.

• Claude Desktop: Settings → Extensions → Configure (junto a Bear Notes) → activa "Content Replacement" → Save → Reinicia Claude

• Servidor MCP independiente: establece la variable de entorno UI_ENABLE_CONTENT_REPLACEMENT=true

Ejemplo de configuración independiente con el reemplazo de contenido habilitado:

{
  "mcpServers": {
    "bear-notes": {
      "command": "npx",
      "args": ["-y", "bear-notes-mcp@latest"],
      "env": {
        "UI_ENABLE_CONTENT_REPLACEMENT": "true"
      }
    }
  }
}

Detalles técnicos

Este servidor lee la base de datos SQLite de Bear Notes directamente para operaciones de búsqueda/lectura y utiliza la API X-callback-URL de Bear para operaciones de escritura. Todo el procesamiento de datos ocurre localmente en tu máquina sin llamadas de red externas.

Plataformas compatibles

Solo macOS, ya que la versión de escritorio de Bear solo funciona en macOS.

Registros (Logs)

Claude Desktop:

• Los registros del servidor MCP van a ~/Library/Logs/Claude/main.log, busca bear-notes-mcp

• Los registros de transporte MCP van a ~/Library/Logs/Claude/mcp-server-Bear\ Notes.log

Servidor MCP independiente:

• Los registros se escriben en stderr; habilita el registro de depuración con UI_DEBUG_TOGGLE=true

Preguntas frecuentes

¿Podría esto robar mis datos?

No. El servidor solo lee la base de datos local de Bear (los mismos datos que te muestra la aplicación Bear) y utiliza la API nativa de Bear para añadir texto a las notas. Sin transmisión de red, sin servidores externos.

¿Por qué SQLite y no solo la API x-callback-url de la aplicación nativa de Bear?

Para las operaciones de lectura (buscar/abrir), la API x-callback-url devuelve los datos de la nota en la respuesta x-success: eso requeriría un servidor o un binario personalizado para manejar las respuestas x-success, lo cual es arriesgado y frágil. El acceso directo de solo lectura a SQLite es más simple y fiable para buscar y leer notas.

¿Por qué Node.js SQLite nativo en lugar de paquetes de terceros?

Esto evita enviar un binario SQLite de paquetes de nodo de terceros, lo que plantea riesgos en la cadena de suministro y bloquea la ejecución de la extensión de Claude Desktop en macOS.

Anthropic no firma binarios SQLite de terceros (obviamente), lo que provoca que los sistemas de seguridad de macOS marquen que el proceso de Claude, firmado por Anthropic, está intentando ejecutar otro binario firmado por un tercero. Como resultado, Claude Desktop no puede ejecutar la extensión.

Cuando instalo la extensión, veo una advertencia roja: "La instalación otorgará acceso a todo en su computadora". - ¿qué significa esto?

Así es como Claude para Desktop reacciona al hecho de que esta extensión necesita acceso a la base de datos SQLite de Bear en tu Mac.

El sistema de advertencia de Claude no distingue entre la necesidad de acceder a un solo archivo (lo que hace la extensión) frente a la necesidad de acceder a todos los archivos (esto NO es lo que hace la extensión).

Una de las formas de validar esto es pedirle a tu Claude que analice el código fuente (es bastante pequeño) antes de instalar la extensión y te lo diga.

¿Cómo puedo informar de un error o contribuir?

¡Usa los issues o las discusiones! ¡Estaré encantado de ver tus comentarios o sugerencias, o tu ayuda para mejorar este proyecto! ❤️

Mantente actualizado

Considera suscribirte a los anuncios de versiones para saber cuándo se lanza una nueva versión:

También publico en reddit.com/r/bearapp/ cuando hay una nueva versión.