EK Bridge

EK Bridge

Dale a los agentes de IA tu calendario. No todo él.
Una aplicación gratuita y de código abierto para la barra de menús de Mac que permite que Claude, ChatGPT, Cursor y tus scripts usen solo los calendarios y listas de recordatorios que elijas, y te pregunta antes de que cambien algo.

Descargar para Mac · Empezar · Configuraciones de agentes · Registro de cambios

• Elige qué puede tocar cada agente. Selecciona los calendarios y listas de recordatorios que cada agente puede usar, y si puede leer, crear, editar, eliminar o completar. Un agente nuevo comienza sin nada.
• Aprueba cada cambio. Un panel muestra exactamente lo que un agente quiere escribir. Nada cambia hasta que hagas clic en Permitir.
• Ve todo, desactívalo con un clic. La actividad nombra qué cambió cada agente y explica cada rechazo. Pausa o elimina un agente, o pausa todo EK Bridge desde la barra de menús.

Funciona con Claude Code, Claude Desktop, Codex y Cursor (probado en vivo), y cualquier otro cliente MCP, con configuraciones listas para VS Code (Copilot), Gemini CLI, Zed, Cline, JetBrains AI Assistant y Devin Desktop. claude.ai y ChatGPT pueden conectarse mediante Acceso remoto, que es experimental.

Qué puedes pedir

Una vez que un agente está conectado, pide en palabras simples. Solo puede actuar dentro de los calendarios y listas que le hayas dado.

Tú pides	El agente usa
"¿Qué hay en mi calendario de Trabajo esta semana y dónde tengo horas libres?"	read_events
"Mueve la revisión de diseño del jueves al viernes a las 3, misma duración."	read_events, luego update_event (que te pregunta primero)
"Recuérdame renovar mi pasaporte el próximo lunes a las 9."	create_reminder en la lista que le concediste
"Bloquea 9:30–10:30 cada día laborable para tiempo de enfoque."	create_event con una regla de repetición

Doce herramientas cubren eventos y recordatorios, con cada campo que Calendar admite: zonas horarias, repeticiones, alertas, ubicaciones, notas y enlaces. Cada agente ve solo las herramientas que su acceso permite. La guía de MCP tiene la referencia completa.

Empezar

1. Instala. Descarga EKBridge.dmg, ábrelo y arrastra EK Bridge a Aplicaciones. Si lo abres desde la imagen de disco o Descargas, se ofrece a moverse allí. O usa Homebrew:

   brew install --cask bereciartua/tap/ek-bridge
   

2. Abre la aplicación. Se abre con una configuración de tres pasos; luego, la encontrarás en la barra de menús.

   1. Permite el acceso a Calendario y Recordatorios. Solo necesitas el que use tu agente; omite el otro.
   2. Añade tu agente. Elige su mosaico (los agentes encontrados en tu Mac aparecen primero) y qué puede leer para empezar, como Leer todos los calendarios y listas. Concede solo Lectura donde el agente la necesite: lo que lee va a su proveedor de IA.
   3. Conéctalo. Añadir a Claude Desktop… (o Cursor, o Claude Code) muestra el cambio exacto en la configuración del agente, guarda una copia de seguridad y nunca escribe el token; también activa EK Bridge. Para otros agentes, copia el comando o la configuración desde la pestaña Conectar de la conexión. El paso está completo cuando llega la primera solicitud del agente.

Eso es todo: pide a tu agente una de las preguntas anteriores. Las configuraciones para cada agente y la solución de problemas están en la guía de MCP.

EK Bridge necesita macOS 14 o posterior, en Apple silicon o Intel. Está notarizado por Apple y se mantiene actualizado (haces clic para instalar cada actualización). Las notas de versión y las sumas de verificación están en Lanzamientos. ¿Actualizando desde EventKit Bridge, su nombre anterior? Consulta Configuración. EK Bridge es un proyecto personal en vista previa pública, con soporte de mejor esfuerzo.

Cómo mantienes el control

EK Bridge es la única aplicación que tiene tu permiso de Calendario y Recordatorios. Tus agentes hablan con ella, nunca directamente con tus calendarios, y verifica cada solicitud contra lo que permitiste.

Cada agente recibe solo lo que marcas

Cada agente tiene su propia clave y su propio acceso: Lectura, Creación, Edición y Eliminación para cada calendario, más Completar para cada lista de recordatorios. Comparte Trabajo, mantén Familia para ti.

Apruebas cada cambio

Por defecto, antes de que un agente escriba algo, un pequeño panel muestra cada campo que quiere establecer. Haz clic en Permitir o Denegar, o deja que un agente trabaje durante 15 minutos. Una solicitud que no respondes se rechaza después de 45 segundos. Para un script de confianza, puedes desactivar la pregunta.

Pregunta antes de rechazar

Cuando un agente intenta añadir, cambiar, completar o eliminar en un calendario que puede leer pero le falta esa acción, EK Bridge te pregunta en el mismo panel: Claude Code no puede añadir recordatorios a Compras. Permitir una vez, Permitir siempre (que guarda solo esa acción) o Ahora no. Nunca pregunta sobre calendarios que el agente no puede ver, y como máximo una vez por hora para lo mismo.

Puedes ver todo y detener cualquier cosa

Actividad dice qué cambió cada agente, por nombre (Movió "Revisión de diseño"), y explica cada rechazo en palabras simples. EK Bridge guarda solo el ID del elemento y busca el nombre cuando abres la fila, con Mostrar en Calendario. Pausa la conexión de un agente para rechazar sus solicitudes mientras mantienes su configuración, Elimínalo para cortarlo definitivamente, o pausa todo EK Bridge desde la barra de menús. Las notificaciones opcionales te informan cuando un cambio no se hizo porque nadie respondió.

Bajo el capó

• Local por defecto. Todo está apagado hasta que lo enciendes. El servidor MCP escucha solo en 127.0.0.1. Sin cuenta, sin análisis, sin servidor nuestro.
• Una clave por agente. Cada agente tiene su propio token de 256 bits, guardado solo como hash; los scripts firman sus solicitudes con su propia clave Ed25519.
• Escrituras seguras. Las ediciones y eliminaciones necesitan la versión más reciente de un elemento. Cada campo escrito se lee de nuevo, y una discrepancia se revierte.
• Nube solo a través de tu túnel. Un agente en la nube puede llegar a EK Bridge solo mediante Acceso remoto y un túnel que tú ejecutas, para agentes que permitiste, y nunca mientras tu Mac esté dormido, sin conexión o cerrado sesión.
• Actualizaciones firmadas. Las actualizaciones vienen de GitHub, firmadas por el desarrollador y verificadas antes de instalarse.
• Código abierto. Lee el código, el modelo de amenazas y el registro de pruebas.

Contra lo que no protege: otro programa que se ejecute como tu usuario de macOS puede leer los mismos archivos de claves. La configuración de acceso separa a los agentes que conectas; no es una defensa contra malware ya presente en tu Mac. Los detalles están en Límite de seguridad.

Preguntas frecuentes

¿Es gratis?

Sí. EK Bridge es de código abierto bajo la Licencia Apache 2.0, sin cuenta ni prueba.

¿Mis datos de calendario salen de mi Mac?

EK Bridge en sí no envía nada a ningún lado; Privacidad enumera cada conexión que hace. Lo que un agente lee a través de ella va a ese agente y su proveedor de IA, bajo sus términos, así que concede Lectura solo donde el agente la necesite.

¿Siempre pregunta antes de un cambio?

Para agentes de IA, sí por defecto. Puedes desactivar la pregunta por conexión, por ejemplo para un script de confianza, o permitir los cambios de un agente durante 15 minutos a la vez. Consulta Preguntar antes de cambios.

¿Qué calendarios funcionan?

Las cuentas que aparecen en las aplicaciones Calendario y Recordatorios, como iCloud, Google, Exchange, CalDAV y En mi Mac. Las pruebas en vivo hasta ahora se ejecutaron en iCloud; consulta Pruebas.

¿Puedo usarlo con ChatGPT o claude.ai?

Sí, mediante Acceso remoto, que reenvía agentes en la nube a tu Mac a través de un túnel que tú ejecutas, como Tailscale Funnel. Está desactivado por defecto y es experimental, y tu Mac debe estar despierta y en línea. Consulta Desde agentes en la nube.

¿Pueden usarlo mis propios scripts?

Sí, con la herramienta de línea de comandos bridge-client. Cada script obtiene su propia clave y su propio acceso, como un agente. Consulta Desde scripts.

¿En qué se diferencia de otros servidores MCP para Mac?

La mayoría da a los agentes acceso amplio a muchas aplicaciones, con un interruptor por aplicación o servicio. EK Bridge hace solo Calendario y Recordatorios, pero por calendario, por agente, con aprobaciones, un registro de actividad y revocación. Si confías en un agente con todo, quizás no lo necesites.

¿Está hecho por Apple?

No. EK Bridge es un proyecto independiente de código abierto construido sobre el framework público EventKit de Apple. No está afiliado ni respaldado por Apple.

¿Algo más? Pregunta en Discusiones.

Más formas de conectar

Desde scripts

Los scripts y herramientas sin MCP usan bridge-client, que firma cada solicitud con la clave propia de la conexión.

1. Añade una conexión con Se conecta desde ▸ Línea de comandos, elige su acceso y Guarda.

2. Instala la herramienta desde Configuración ▸ Avanzado ▸ Instalar herramienta de línea de comandos. Enlaza bridge-client en ~/.local/bin; si tu shell no la encuentra, añade esa carpeta a tu PATH. (Homebrew ya la enlazó en su propio bin.)

3. Envía una solicitud de prueba. La página de la conexión la tiene lista para copiar:

   bridge-client scope_status --client "Morning briefing"
   

Hasta que la herramienta esté instalada, el comando copiado usa la ruta completa de la aplicación, /Applications/EKBridge.app/Contents/MacOS/bridge-client, así que funciona tal como se pega. bridge-client --help enumera cada comando y el acceso que necesita. Los errores dicen qué está mal y cómo arreglarlo, con un código de salida distinto para cada tipo de problema. Consulta Una primera verificación CLI segura y la referencia de API y CLI.

Desde agentes en la nube (experimental)

Los agentes en la nube se ejecutan en los servidores de su proveedor y no pueden llegar a 127.0.0.1. Acceso remoto (su propia página en la barra lateral, con una configuración guiada; desactivado por defecto) abre un segundo puerto de bucle local, 47616, para un túnel que tú ejecutas, como Tailscale Funnel; la aplicación muestra los comandos y prueba el resultado. Cada conexión también necesita Permitir acceso en la nube.

• Los agentes que envían un encabezado (las API de Anthropic y OpenAI, Claude Code en la web, agentes en la nube de Cursor y Copilot, Devin) usan el token remoto separado de la conexión.
• claude.ai, ChatGPT y Gemini Enterprise inician sesión con OAuth, que apruebas en el Mac emparejando un código de seis dígitos. El Acceso Remoto tiene pruebas sin conexión, pero aún no se ha probado en vivo con cada agente y túnel de la nube. Actívalo solo mientras lo necesites y mantén privada su URL; su ruta es el secreto. Consulta Uso desde agentes de la nube.

Guías

Objetivo	Guía
Instalar, compilar desde el código fuente, firma y acceso a macOS	Configuración
Añadir una conexión y usar la aplicación	Guía de usuario
Conectar un agente de IA a través de MCP, o un agente de la nube mediante Acceso Remoto; referencia de herramientas	Guía de MCP
Llamar a la CLI y comprender los parámetros de los comandos	Referencia de API y CLI
Comprender procesos, almacenamiento de archivos y límites de seguridad	Arquitectura y modelo de amenazas
Ver qué se probó y diagnosticar fallos	Pruebas y solución de problemas
Contribuir, o mantener y publicar	Contribuir, Mantener

Privacidad

La aplicación no tiene análisis, telemetría ni informes de fallos, y no requiere cuenta. Tus calendarios, recordatorios, conexiones y actividad permanecen en tu Mac. Estas son todas las conexiones de red que realiza:

Conexión	Cuándo
Servidor MCP, escuchando en 127.0.0.1:47615	Solo mientras EK Bridge está activo y una conexión tiene acceso MCP (Configuración ▸ Avanzado ▸ Servidor MCP local lo desactiva). Solo bucle local: otros ordenadores no pueden conectarse.
Acceso Remoto, escuchando en 127.0.0.1:47616	Solo mientras Acceso Remoto está activo (desactivado por defecto). Solo bucle local; un túnel que ejecutes reenvía agentes de la nube a él.
Una solicitud HTTPS a tu dirección de Acceso Remoto	Solo cuando la guía de Acceso Remoto prueba el túnel, o haces clic en Probar en la página de Acceso Remoto.
Una solicitud HTTPS para los metadatos del cliente de un agente de la nube	Solo mientras vinculas un agente de la nube OAuth (claude.ai, ChatGPT), a la dirección que ese agente proporcione. Se rechazan direcciones privadas y locales.
bridge-mcp conectándose a 127.0.0.1	Cuando un agente en tu Mac lo inicia, para llegar al servidor MCP.
Una solicitud HTTPS a GitHub para appcast.xml, la lista de la última versión	Una vez al día mientras Configuración ▸ General ▸ Buscar actualizaciones automáticamente está activo (activado en copias descargadas; una copia compilada desde el código fuente nunca lo comprueba), y cuando eliges Buscar actualizaciones…. GitHub ve tu dirección IP y la versión de la aplicación; no se envía nada más.
Descargar una actualización desde GitHub	Solo después de hacer clic en Instalar actualización en la ventana de actualización. La aplicación verifica la firma EdDSA de la descarga y que esté firmada por el mismo desarrollador antes de instalarla.

En el disco, además de conexiones y actividad, EK Bridge guarda los nombres, cuentas y colores de los calendarios y listas a los que has dado acceso (collection-labels.json), para poder nombrar uno que deje de estar disponible. La actividad guarda el ID de EventKit de un elemento para cada cambio (no su título) y lo busca cuando abres la fila; EK Bridge nunca almacena títulos ni contenidos de elementos.

Las notificaciones las muestra macOS. Una sobre un cambio que no se realizó puede incluir el título del elemento, que macOS puede mostrar en la pantalla de bloqueo según tu configuración; activa o desactiva cada tipo en Configuración ▸ General ▸ Notificaciones.

Lo que un agente lee a través de EK Bridge va a ese agente y a su proveedor de IA, bajo sus términos de privacidad, así que concede solo lo que cada agente necesite. Los túneles distintos de Tailscale Funnel pueden leer el tráfico de Acceso Remoto en su borde.

Límite de seguridad

• Claves de script. EK Bridge almacena la credencial de firma Ed25519 de cada conexión de línea de comandos en un archivo con permisos 0600 en tu directorio de Application Support; el registro almacena solo un verificador público y las concesiones.
• Servidor MCP. Se ejecuta solo mientras EK Bridge está activo y una conexión tiene acceso MCP. Escucha solo en 127.0.0.1:47615, nunca en una interfaz de red. Cada solicitud necesita el token de 256 bits propio de la conexión, guardado en un archivo con permisos 0600; el registro almacena solo su hash SHA-256, y las configuraciones recomendadas de agentes leen el archivo en lugar de poner el token en la configuración del agente. Se rechazan solicitudes con un Host ajeno, cualquier Origin (páginas web) o cabeceras de reenvío de túneles, y los intentos de inicio de sesión fallidos repetidos se bloquean. Consulta la revisión de amenazas.
• Acceso Remoto. También desactivado por defecto. Mientras está activo, escucha en 127.0.0.1:47616 para un túnel que ejecutes; cada ruta excepto una ruta secreta de 128 bits recibe 404, y solo las conexiones con Permitir acceso desde la nube pueden usarlo, con un token remoto separado o una conexión OAuth que aprobaste en el Mac. Los tokens locales no funcionan a través de él, y sus credenciales no funcionan en el puerto local. Consulta la revisión de amenazas de Acceso Remoto.
• Los archivos de solicitud son de tu propiedad y tienen permisos restringidos.

Estos controles no aíslan otro proceso que se ejecute como el mismo usuario de macOS. Tal proceso puede acceder a los archivos de credenciales, tokens o políticas. Una concesión es, por tanto, un límite entre las conexiones en el protocolo de esta aplicación, no una defensa contra una cuenta de usuario comprometida.

Reporta vulnerabilidades de forma privada, como se describe en SECURITY.md.

Qué funciona hoy

La versión corta está arriba. La lista completa, con lo que EventKit no permite:

Mostrar la lista completa

• El usuario elige colecciones y concesiones de Lectura, Crear, Editar, Eliminar o Completar recordatorios por conexión. Las nuevas conexiones tienen cero concesiones. Las concesiones guardadas persisten hasta que se editan o se elimina la conexión; EK Bridge en sí está desactivado hasta que se activa localmente. Una conexión puede pausarse, lo que rechaza sus solicitudes pero mantiene sus credenciales y acceso, y reanudarse después.
• Los agentes de IA en el Mac usan doce herramientas MCP (list_collections, read_events, get_event, create_event, update_event, delete_event, read_reminders, get_reminder, create_reminder, update_reminder, complete_reminder, delete_reminder) con horas ISO 8601. Cada agente ve solo las herramientas que sus concesiones permiten. Preguntar antes de cambios puede requerir tu aprobación para cada escritura, por conexión, y muestra cada campo que cambiaría.
• Las lecturas devuelven filas limitadas de eventos o recordatorios, no acceso sin restricciones al almacén de EventKit del usuario. Se deniegan lecturas de otras colecciones. Las escrituras usan una clave de idempotencia; las ediciones y eliminaciones requieren la última versión del elemento.
• Los eventos admiten cada campo que EventKit expone: horas guardadas en la zona horaria que elijas (o la del Mac, nunca UTC por defecto), eventos de todo el día hasta un año, notas, ubicación con un pin en el mapa, URL, alarmas (incluyendo llegar o salir de un lugar), disponibilidad y reglas de repetición. Los eventos recurrentes pueden cambiarse o eliminarse una ocurrencia a la vez, desde una ocurrencia en adelante, o como serie completa. Los asistentes, el organizador y tu respuesta son legibles; las invitaciones permanecen de solo lectura, porque cambiarlas puede notificar a cada asistente.
• Los recordatorios admiten título, fechas de vencimiento e inicio, notas, URL, prioridad, varias alarmas (incluidas alarmas de ubicación), reglas de repetición, completar y reabrir, mover entre listas y eliminar un recordatorio repetido como serie. Una ocurrencia de un recordatorio repetido puede completarse para las formas y tipos de cuenta que una sonda supervisada ha verificado (hoy un recordatorio diario de iCloud con hora de vencimiento).
• Las actualizaciones cambian solo los campos que envían, y cada campo escrito se lee de vuelta: una discrepancia elimina un elemento nuevo o restaura uno editado. Invitar personas, responder invitaciones, adjuntos, tiempo de viaje y las etiquetas y subtareas de la aplicación Recordatorios no son posibles a través de EventKit.
• Los agentes de la nube pueden usar las mismas herramientas a través de Acceso Remoto, un túnel que ejecutes y un interruptor Permitir acceso desde la nube por conexión, con un token remoto separado por conexión o conexiones OAuth que apruebes en el Mac. Acceso Remoto está desactivado por defecto, puede desactivarse solo con un temporizador y está a un clic de desactivarse desde la barra de menú.
• Cuando a un agente le falta una acción en un calendario o lista que ya puede leer, EK Bridge te pregunta (Permitir una vez, Permitir siempre, Ahora no) en lugar de rechazar directamente; solo escrituras, limitadas y conmutable por conexión.
• Una ventana con Resumen, Actividad (qué cambió, por nombre de elemento buscado en vivo desde su ID de EventKit almacenado; cambios y problemas guardados durante 90 días; si cada solicitud llegó vía MCP, Acceso Remoto o línea de comandos), cada conexión y Configuración; un icono en la barra de menú que muestra si EK Bridge está activo, pausado o necesita atención, con un globo mientras Acceso Remoto está activo; notificaciones opcionales; y una lista de verificación de primer uso.
• La aplicación puede iniciarse al iniciar sesión cuando lo actives.

La matriz de soporte y el registro de pruebas distinguen el comportamiento implementado de las observaciones específicas del proveedor y los casos no probados.

Compilar desde el código fuente

Necesitas macOS 14 o posterior, Xcode o las Herramientas de línea de comandos de Xcode, y Python 3. Compilar y las pruebas sin conexión no instalan la aplicación ni piden acceso:

sh test.sh
sh build.sh

La compilación crea build/EKBridge.app, con el lanzador MCP bridge-mcp y el cliente de línea de comandos bridge-client dentro (build/bridge-client enlaza a él). Firma la aplicación ad hoc por defecto, lo que macOS trata como una aplicación nueva cada vez; para acceso duradero a Calendario y Recordatorios, firma con una identidad estable como se describe en Configuración.

• EVENTKIT_ARCHS="arm64 x86_64" sh build.sh compila una aplicación universal.
• sh ui_test.sh ejecuta las pruebas de ventana y comportamiento, y sh ui_snapshots.sh escribe capturas de pantalla de cada pantalla; ambas usan datos falsos.
• Las versiones se compilan con release.sh (firma Developer ID, notarización, un DMG y un zip), a mano o con el flujo de trabajo de publicación; consulta Mantener.

Para contribuir, consulta Contribuir.

Desinstalar

1. Sal de la aplicación desde su menú en la barra de menú.

2. Elimina su acceso a Calendario y Recordatorios. El primer comando lee el ID de paquete de la aplicación, así que ejecuta estos antes de eliminar la aplicación:

   bundle_id=$(defaults read /Applications/EKBridge.app/Contents/Info CFBundleIdentifier)
   tccutil reset Calendar "$bundle_id"
   tccutil reset Reminders "$bundle_id"
   

3. Elimina la aplicación de Aplicaciones y sus datos: ~/Library/Application Support/EKBridge (conexiones, claves, tokens, actividad y el diario de escritura). Si actualizaste desde EventKit Bridge, también elimina el enlace EventKitBridge junto a él. La configuración y las descargas del actualizador están en ~/Library/Preferences/io.github.bereciartua.ekbridge.plist y ~/Library/Caches/io.github.bereciartua.ekbridge.

4. Si instalaste la herramienta de línea de comandos, elimina ~/.local/bin/bridge-client.

5. Elimina el servidor de las configuraciones de tus agentes (por ejemplo claude mcp remove ek-bridge) y detén cualquier túnel que ejecutaras para Acceso Remoto.

¿Instalado con Homebrew? Haz los pasos 1, 2 y 5, y brew uninstall --cask ek-bridge elimina la aplicación y su enlace bridge-client; con --zap también mueve los datos y la configuración del paso 3 a la Papelera.

Estado del proyecto

EK Bridge está en vista previa pública, con soporte de mejor esfuerzo.

• Probado sin conexión: el puente local y la interfaz; el servidor MCP, el lanzador, las configuraciones de agentes, Acceso Remoto y su servidor OAuth, sobre sockets de bucle local reales y un dispositivo HTTPS local.
• Probado en vivo: pruebas limitadas en elementos sintéticos de EventKit, un reinicio completo del Mac e inicio de sesión con lecturas limitadas aún funcionando, y una primera comprobación con Claude Code, Claude Desktop, Codex y Cursor (conectar, leer, una escritura aprobada, una solicitud rechazada). Probado en macOS 27.0.1 en Apple silicon con iCloud.
• Aún no ejecutado: la matriz completa de agentes en vivo y la matriz de nube en vivo. El comportamiento de notificaciones y sincronización del proveedor no está establecido para cada forma de repetición.

Consulta pruebas y comprobaciones abiertas y el registro de cambios.

Licencia

EK Bridge está licenciado bajo la Apache License 2.0; consulta NOTICE. La licencia no otorga derechos sobre el nombre o icono del proyecto. Apple, Mac y macOS son marcas comerciales de Apple Inc. Este proyecto no está afiliado ni respaldado por Apple.

EK Bridge está hecho por Martin Bereciartua.