Servidor iCal de MCP

🗓️ Gestión de calendarios en lenguaje natural para macOS

🌟 Descripción general

¡Transforma tu interacción con tu calendario de macOS usando lenguaje natural! El servidor mcp-ical aprovecha el Protocolo de Contexto de Modelo (MCP) para convertir la gestión de tu calendario en una experiencia conversacional.

You: "What's my schedule for next week?"
Claude: "Let me check that for you..."
[Displays a clean overview of your upcoming week]

You: "Add a lunch meeting with Sarah tomorrow at noon"
Claude: "✨ 📅 Created: Lunch with Sarah Tomorrow, 12:00 PM"

✨ Características

📅 Creación de eventos

¡Transforma el lenguaje natural en eventos de calendario al instante!

"Schedule a team lunch next Thursday at 1 PM at Bistro Garden"
↓
📎 Created: Team Lunch
   📅 Thursday, 1:00 PM
   📍 Bistro Garden

Funciones compatibles

Selección de calendario personalizado
Ubicación y notas
Recordatorios inteligentes
Eventos recurrentes

Ejemplos de usuarios avanzados

🔄 Recurring Events:
"Set up my weekly team sync every Monday at 9 AM with a 15-minute reminder"

📝 Detailed Events:
"Schedule a product review meeting tomorrow from 2-4 PM in the Engineering calendar, 
add notes about reviewing Q1 metrics, and remind me 1 hour before"

📱 Multi-Calendar Support:
"Add a dentist appointment to my Personal calendar for next Wednesday at 3 PM"

🔍 Gestión inteligente de horarios y disponibilidad

Acceso rápido a tu agenda con consultas naturales:

"What's on my calendar for next week?"
↓
📊 Shows your upcoming events with smart formatting

"When am I free to schedule a 2-hour meeting next Tuesday?"
↓
🕒 Available time slots found:
   • Tuesday 10:00 AM - 12:00 PM
   • Tuesday 2:00 PM - 4:00 PM

✏️ Actualizaciones de eventos inteligentes

Modificar eventos de forma natural:

Before: "Move tomorrow's team meeting to 3 PM instead"
↓
After: ✨ Meeting rescheduled to 3:00 PM

Capacidades de actualización

Modificaciones de fecha y hora
Transferencias de calendario
Actualizaciones de ubicación
Adiciones de notas
Ajustes de recordatorio
Cambios de patrones recurrentes

📊 Gestión del calendario

Ver todos los calendarios disponibles
Sugerencias de calendario inteligente
Integración perfecta con Google Calendar cuando se configura con iCloud

Consejo profesional : Como puedes crear eventos en calendarios personalizados, si tienes tu Calendario de Google sincronizado con tu Calendario de iCloud, ¡también puedes usar este servidor MCP para crear eventos en tu Calendario de Google! Solo especifica el Calendario de Google al crear o actualizar eventos.

🚀 Inicio rápido

Nota : Aunque estas instrucciones se centran en la configuración del servidor MCP con Claude for Desktop, este servidor puede usarse con cualquier cliente compatible con MCP. Para más información sobre el uso de diferentes clientes, consulte la documentación de MCP .

Prerrequisitos

administrador de paquetes uv
macOS con la aplicación Calendario configurada
Se recomienda un cliente MCP: Claude para escritorio

Instalación

Si bien este servidor MCP se puede utilizar con cualquier cliente compatible con MCP, las instrucciones a continuación son para su uso con Claude para escritorio.

Clonar y configurar
# Clone the repository git clone https://github.com/Omar-V2/mcp-ical.git cd mcp-ical # Install dependencies uv sync
Configurar Claude para escritorioCree o edite ~/Library/Application\ Support/Claude/claude_desktop_config.json :
{ "mcpServers": { "mcp-ical": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-ical", "run", "mcp-ical" ] } } }
Iniciar Claude para acceder al calendario
⚠️ Importante : Es necesario iniciar Claude desde la terminal para solicitar correctamente los permisos del calendario. Iniciarlo directamente desde el Finder no activará la solicitud de permisos.
Ejecute el siguiente comando en su terminal.
/Applications/Claude.app/Contents/MacOS/Claude
⚠️ Advertencia : Alternativamente, puede otorgar acceso al calendario manualmente , pero esto implica modificar archivos del sistema y solo debe hacerse si comprende los riesgos involucrados.
¡Empieza a usarlo!
Try: "What's my schedule looking like for next week?"

🔑 Nota : Al usar por primera vez un comando relacionado con el calendario, macOS solicitará acceso al mismo. Este aviso solo aparecerá si iniciaste Claude desde la terminal, como se especificó anteriormente.

🧪 Pruebas

⚠️ Advertencia : Las pruebas crearán calendarios y eventos temporales. Aunque la limpieza es automática, ejecute las pruebas solo en entornos de desarrollo.

# Install dev dependencies
uv sync --dev

# Run test suite
uv run pytest tests

🐛 Problemas conocidos

Eventos recurrentes

Es posible que los horarios recurrentes no estándar no siempre se configuren correctamente
Mejores resultados con Claude 3.5 Sonnet en comparación con Haiku
El tiempo de recordatorio para eventos recurrentes que duran todo el día puede tener un día de diferencia

🤝 Contribuyendo

Agradecemos sus comentarios y contribuciones. Así es como puede ayudar:

Bifurcar el repositorio
Crea tu rama de funciones
Confirme sus cambios
Empujar hacia la rama
Abrir una solicitud de extracción

📝 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

🙏 Agradecimientos

Construido con el Protocolo de Contexto de Modelo
Integración del calendario de macOS creada con PyObjC

MCP iCal Server

Integrations