Servidor MCP de Fantastical

Servidor MCP para Fantastical, la potente aplicación de calendario para macOS.

¿Por qué usar esto?

• Creación de eventos en lenguaje natural - Utiliza el potente análisis de lenguaje natural de Fantastical ("Reunión con Juan mañana a las 3pm")

• Ver tu horario - Consulta los eventos de hoy o las próximas citas sin salir de tu conversación

• Acceso rápido al calendario - Salta a cualquier fecha en Fantastical al instante

• IA consciente del calendario - Permite que Claude entienda tu disponibilidad y el contexto de tu agenda

• Configuración cero - Funciona con tu configuración existente de Fantastical y Calendario

Related MCP server: Apple Calendar MCP Server

Características

Requisitos previos

• macOS (Fantastical es exclusivo de macOS)

• Node.js 18+

• Fantastical instalado

• Permisos de acceso al calendario para Terminal/Claude

Instalación

Usando npm (Recomendado)

npx mcp-fantastical

Desde el código fuente

git clone https://github.com/aplaceforallmystuff/mcp-fantastical.git
cd mcp-fantastical
npm install
npm run build

Configuración

No se requieren claves API: este servidor utiliza AppleScript para comunicarse con Fantastical y la aplicación Calendario.

Para Claude Desktop

Añade esto a tu archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fantastical": {
      "command": "npx",
      "args": ["-y", "mcp-fantastical"]
    }
  }
}

Para Claude Code

Añade esto a ~/.claude.json:

{
  "mcpServers": {
    "fantastical": {
      "command": "npx",
      "args": ["-y", "mcp-fantastical"]
    }
  }
}

Permisos

En la primera ejecución, es posible que debas conceder los siguientes permisos:

Accesibilidad (para la creación de eventos mediante esquema de URL):

1. Ajustes del Sistema → Privacidad y seguridad → Accesibilidad

2. Añade Terminal (o tu aplicación de terminal) a la lista de permitidos

Acceso completo al calendario (para leer eventos):

El asistente nativo se distribuye como un paquete .app firmado ad-hoc (FantasticalHelper.app). La primera vez que el servidor MCP lea datos del calendario, macOS mostrará un aviso único atribuido a "FantasticalHelper" solicitando acceso completo al calendario. Acéptalo.

Si te pierdes el aviso o necesitas volver a concederlo más tarde:

1. Ajustes del Sistema → Privacidad y seguridad → Calendarios

2. Habilita FantasticalHelper

Nota: Las versiones anteriores incluían un binario auxiliar sin procesar, al cual macOS no podía atribuir un permiso TCC cuando se ejecutaba bajo Claude Desktop; el aviso nunca aparecía y el acceso se denegaba silenciosamente (#6). El asistente empaquetado y firmado soluciona esto.

Ejemplos de uso

Creación de eventos

• "Programa una reunión con el equipo mañana a las 2pm"

• "Añade una cita con el dentista el viernes a las 10am a mi calendario Personal"

• "Crea una reunión recurrente todos los lunes a las 9am"

• "Bloquea la tarde del próximo martes para trabajo profundo"

Visualización de la agenda

• "¿Qué hay en mi calendario hoy?"

• "Muéstrame mi agenda para la próxima semana"

• "¿Qué reuniones tengo mañana?"

• "¿Estoy libre el viernes por la tarde?"

Navegación

• "Abre mi calendario el próximo lunes"

• "Muéstrame el 25 de diciembre en Fantastical"

• "Salta a la próxima semana en mi calendario"

Búsqueda

• "Encuentra todas las reuniones con Sarah"

• "Busca citas con el dentista"

• "Busca reuniones de revisión de proyectos"

Herramientas disponibles

Desarrollo

# Watch mode for development
npm run watch

# Build TypeScript
npm run build

# Run locally
node dist/index.js

Solución de problemas

"AppleScript error: Not authorized to send Apple events"

Concede permisos de accesibilidad:

1. Abre Ajustes del Sistema → Privacidad y seguridad → Accesibilidad

2. Haz clic en el candado para realizar cambios

3. Añade Terminal (o tu aplicación de terminal) y habilítala

Errores de permiso de calendario, o "Calendar access denied" en Claude Desktop

Los permisos TCC de macOS no se heredan a través de la cadena Claude Desktop → npx → node → helper. El asistente nativo está envuelto en un paquete FantasticalHelper.app firmado ad-hoc para que macOS tenga una identidad de código estable a la que atribuir el permiso de calendario.

Soluciones:

1. Busca un aviso del sistema único atribuido a FantasticalHelper y acéptalo. Si apareció detrás de otra ventana, reinicia tu cliente MCP e inténtalo de nuevo.

2. Comprueba Ajustes del Sistema → Privacidad y seguridad → Calendarios y habilita FantasticalHelper.

3. Si ejecutas desde el código fuente, reconstruye el paquete: npm run build:native.

4. Si al paquete le falta una firma de código por cualquier motivo, vuelve a firmarlo: codesign --force --sign - dist/native/FantasticalHelper.app.

"Error: This MCP server only works on macOS"

Este servidor requiere macOS porque Fantastical es una aplicación de macOS. Utiliza AppleScript para comunicarse con Fantastical y la aplicación Calendario.

Los eventos no aparecen

• Asegúrate de que Fantastical se esté sincronizando con iCloud/Calendario

• Comprueba que la aplicación Calendario tenga acceso a los mismos calendarios

• Verifica que el evento se haya creado en el calendario correcto

• Concede acceso completo al calendario (ver arriba)

Fantastical no se abre

• Asegúrate de que Fantastical esté instalado

• Intenta abrir Fantastical manualmente primero

• Comprueba que los esquemas de URL estén habilitados en las preferencias de Fantastical

Licencia

MIT - consulta LICENSE para más detalles.

Enlaces

• Fantastical - Sitio web oficial de Fantastical

• Model Context Protocol - Especificación de MCP

• Repositorio de GitHub