Skip to main content
Glama

apple-notes-mcp

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

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
  1. Distribuciones de paquetes de compilación:
uv build

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

  1. 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.

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Permite que la IA lea desde su base de datos local de Apple Notes (solo macOS)

  1. Componentes
    1. Recursos
    2. Herramientas
    3. Características faltantes:
  2. Inicio rápido
    1. Instalar el servidor
  3. Permisos de disco de Mac OS
    1. Desarrollo
      1. Construcción y publicación
      2. Depuración
    2. Licencia
      1. Código fuente
        1. Contribuyendo

          Related MCP Servers

          • A
            security
            A
            license
            A
            quality
            A simple note-taking MCP server for recording and managing notes with AI models.
            Last updated -
            4
            66
            21
            TypeScript
            GPL 2.0
          • -
            security
            A
            license
            -
            quality
            Allows the AI to read from your Bear Notes
            Last updated -
            8
            26
            JavaScript
            MIT License
            • Apple
          • A
            security
            A
            license
            A
            quality
            Enables interaction with Apple Notes via natural language, supporting note creation, search, and retrieval with iCloud integration for seamless note management.
            Last updated -
            3
            2
            TypeScript
            MIT License
            • Apple
          • -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that enables semantic search and retrieval of Apple Notes content, allowing AI assistants to access, search, and create notes using on-device embeddings.
            Last updated -
            TypeScript
            • Apple

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/sirmews/apple-notes-mcp'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server