Servidor de protocolo de contexto de modelo de Apple Notes para Claude Desktop.

Lea su base de datos local de Apple Notes y proporciónela a Claude Desktop.

Ahora Claude puede buscar tus notas más olvidadas y saber aún más sobre ti.

Nada podría salir mal.

Componentes

Recursos

El servidor implementa la capacidad de leer y escribir en sus Apple Notes.

Herramientas

El servidor proporciona múltiples indicaciones:

• get-all-notes : obtener todas las notas.

• read-note : obtiene el contenido completo de una nota específica.

• search-notes : busca entre notas.

Características faltantes:

• No se admiten notas cifradas (ZISPASSWORDPROTECTED)

• No hay soporte para el filtrado de notas fijadas

• No se gestiona el estado de sincronización en la nube

• Recuperación de contenido adjunto faltante

• No hay soporte para el estado de la lista de verificación (ZHASCHECKLIST)

• No hay posibilidad de crear o editar notas

Related MCP server: Bear MCP Server

Inicio rápido

Instalar el servidor

Se recomienda utilizar uv para instalar el servidor localmente para Claude.

uvx apple-notes-mcp

O

uv pip install apple-notes-mcp

Agregue su configuración como se describe a continuación.

Escritorio de Claude

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

Nota: Es posible que necesites usar la ruta directa a uv . Usa which uv para encontrar la ruta.

Configuración de servidores no publicados/desarrollo

"mcpServers": {
  "apple-notes-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "{project_dir}",
      "run",
      "apple-notes-mcp"
    ]
  }
}

Configuración de servidores publicados

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

Permisos de disco de Mac OS

Necesitará otorgar acceso total al disco del servidor. Esto se debe a que la base de datos SQLite de Apple Notes está anidada en el sistema de archivos de macOS.

Es posible que en el futuro considere una solución AppleScript si esto me molesta más o si quiero comenzar a agregar/agregar a Apple Notes.

Desarrollo

Construcción y publicación

Para preparar el paquete para su distribución:

1. Sincronizar dependencias y actualizar el archivo de bloqueo:

uv sync

2. Distribuciones de paquetes de compilación:

uv build

Esto creará distribuciones de origen y de rueda en el directorio dist/ .

3. Publicar en PyPI:

uv publish

Nota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores de comando:

• Token: --token o UV_PUBLISH_TOKEN

• O nombre de usuario/contraseña: --username / UV_PUBLISH_USERNAME y --password / UV_PUBLISH_PASSWORD

Depuración

Dado que los servidores MCP se ejecutan en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .

Puede iniciar el Inspector MCP a través de npm con este comando:

npx @modelcontextprotocol/inspector uv --directory {project_dir} run apple-notes-mcp

Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.

Código fuente

El código fuente está disponible en GitHub .

Contribuyendo

Envíeme sus ideas y comentarios a través de Bluesky o abriendo un problema.