MCP iCal Server

Servidor MCP iCal

🌟 Descripción general

¡Transforma la forma en que interactúas con el calendario de macOS usando lenguaje natural! El servidor mcp-ical aprovecha el Protocolo de Contexto de Modelos (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

¡Convierte 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 para 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 en lenguaje natural:

"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 inteligentes de eventos

Modifica 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 hora y fecha
• Transferencias entre calendarios
• Actualizaciones de ubicación
• Adición de notas
• Ajustes de recordatorios
• Cambios en patrones recurrentes

📊 Gestión de calendarios

• Ver todos los calendarios disponibles
• Sugerencias inteligentes de calendario
• Integración fluida con Google Calendar cuando se configura con iCloud

💡 Consejo profesional: Dado que puedes crear eventos en calendarios personalizados, si tienes tu Google Calendar sincronizado con tu iCloud Calendar, ¡también puedes usar este servidor MCP para crear eventos en tu Google Calendar! Solo especifica el calendario de Google al crear/actualizar eventos.

🚀 Inicio rápido

💡 Nota: Aunque estas instrucciones se centran en configurar el servidor MCP con Claude para Desktop, este servidor puede usarse con cualquier cliente compatible con MCP. Para más detalles sobre el uso de diferentes clientes, consulta la documentación de MCP.

Requisitos previos

• Gestor de paquetes uv
• macOS con la aplicación Calendario configurada
• Un cliente MCP: se recomienda Claude para escritorio

Instalación

Aunque este servidor MCP puede usarse con cualquier cliente compatible con MCP, las instrucciones a continuación son para usarlo con Claude para escritorio.

1. Clonar y configurar

   # Clone the repository
   git clone https://github.com/Omar-V2/mcp-ical.git
   cd mcp-ical
   
   # Install dependencies
   uv sync
   

2. Configurar Claude para Desktop

   Crea o edita ~/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"
               ]
           }
       }
   }
   

3. Iniciar Claude para acceso al calendario

   ⚠️ Importante: Claude debe iniciarse desde la terminal para solicitar correctamente los permisos de calendario. Iniciarlo directamente desde Finder no activará la solicitud de permisos.

   Ejecuta el siguiente comando en tu terminal.

   /Applications/Claude.app/Contents/MacOS/Claude
   

   ⚠️ Advertencia: Alternativamente, puedes conceder acceso al calendario manualmente, pero esto implica modificar archivos del sistema y solo debe hacerse si comprendes los riesgos involucrados.

4. ¡Empieza a usarlo!

   Try: "What's my schedule looking like for next week?"
   

🔑 Nota: Cuando uses por primera vez un comando relacionado con el calendario, macOS solicitará acceso al calendario. Esta solicitud 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, solo ejecutes pruebas en entornos de desarrollo.

# Install dev dependencies
uv sync --dev

# Run test suite
uv run pytest tests

🐛 Problemas conocidos

Eventos recurrentes

• Los horarios recurrentes no estándar pueden no configurarse siempre correctamente
• Mejores resultados con Claude 3.5 Sonnet en comparación con Haiku
• El tiempo de los recordatorios para eventos recurrentes de todo el día puede desviarse un día

🤝 Contribuciones

Los comentarios y las contribuciones son bienvenidos. Así es como puedes ayudar:

1. Haz un fork del repositorio
2. Crea tu rama de características
3. Haz commit de tus cambios
4. Haz push a la rama
5. Abre una Solicitud de Extracción (Pull Request)

📝 Licencia

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

🙏 Agradecimientos

• Construido con Protocolo de Contexto de Modelos
• Integración con el calendario de macOS construida con PyObjC