Skip to main content
Glama
Sign In
enesjakozh

Outlook Calendar MCP

by merajmehrabi
npmGitHub
MIT License
39
10
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

local-only server

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

Herramienta MCP del calendario de Outlook

Un servidor de Protocolo de contexto de modelo (MCP) que le permite a Claude acceder y administrar su calendario local de Microsoft Outlook (solo Windows).

Características

  • Ver eventos del calendario : enumera eventos dentro de un rango de fechas, ve detalles del evento, verifica el estado del asistente
  • Administrar eventos del calendario : crear nuevos eventos y reuniones, actualizar eventos existentes
  • Inteligencia de calendario : encuentre franjas horarias libres para programar e identifique los horarios óptimos para reuniones
  • Compatibilidad con varios calendarios : acceda a diferentes calendarios en su perfil de Outlook

Prerrequisitos

  • Sistema operativo Windows
  • Cliente de escritorio Microsoft Outlook instalado
  • Node.js (versión 14.x o superior)
  • npm (viene con Node.js)

Instalación

Opción 1: Instalar desde npm

npm install -g outlook-calendar-mcp

También puedes ejecutarlo directamente sin instalación usando npx:

npx outlook-calendar-mcp

Opción 2: Instalar desde la fuente

  1. Clona este repositorio o descarga el código fuente
  2. Instalar dependencias:
npm install
  1. Ejecutar el servidor:
npm start

Configuración del servidor MCP

Para utilizar esta herramienta con Claude, debes agregarla a tu archivo de configuración de MCP.

Para la aplicación de escritorio de Claude

Agregue lo siguiente a su archivo de configuración de Claude Desktop (ubicado en %APPDATA%\Claude\claude_desktop_config.json ):

Si se instala globalmente a través de npm:

{ "mcpServers": { "outlook-calendar": { "command": "outlook-calendar-mcp", "args": [], "env": {} } } }

Usando npx (sin instalación):

{ "mcpServers": { "outlook-calendar": { "command": "npx", "args": ["-y", "outlook-calendar-mcp"], "env": {} } } }

Si se instala desde la fuente:

{ "mcpServers": { "outlook-calendar": { "command": "node", "args": ["path/to/outlook-calendar-mcp/src/index.js"], "env": {} } } }

Para la extensión VSCode de Claude

Agregue lo siguiente a su archivo de configuración MCP de la extensión Claude VSCode (ubicado en %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json ):

Si se instala globalmente a través de npm:

{ "mcpServers": { "outlook-calendar": { "command": "outlook-calendar-mcp", "args": [], "env": {} } } }

Usando npx (sin instalación):

{ "mcpServers": { "outlook-calendar": { "command": "npx", "args": ["-y", "outlook-calendar-mcp"], "env": {} } } }

Si se instala desde la fuente:

{ "mcpServers": { "outlook-calendar": { "command": "node", "args": ["path/to/outlook-calendar-mcp/src/index.js"], "env": {} } } }

Para la instalación de origen, reemplace path/to/outlook-calendar-mcp con la ruta real donde instaló esta herramienta.

Uso

Una vez configurado, Claude tendrá acceso a las siguientes herramientas:

Lista de eventos del calendario

list_events - startDate: Start date in MM/DD/YYYY format - endDate: End date in MM/DD/YYYY format (optional) - calendar: Calendar name (optional)

Ejemplo: "Enumerar mis eventos del calendario para la próxima semana"

Crear evento de calendario

create_event - subject: Event subject/title - startDate: Start date in MM/DD/YYYY format - startTime: Start time in HH:MM AM/PM format - endDate: End date in MM/DD/YYYY format (optional) - endTime: End time in HH:MM AM/PM format (optional) - location: Event location (optional) - body: Event description (optional) - isMeeting: Whether this is a meeting with attendees (optional) - attendees: Semicolon-separated list of attendee email addresses (optional) - calendar: Calendar name (optional)

Ejemplo: "Agregar una reunión con John sobre la propuesta del proyecto el viernes a las 2 p. m."

Encuentra franjas horarias libres

find_free_slots - startDate: Start date in MM/DD/YYYY format - endDate: End date in MM/DD/YYYY format (optional) - duration: Duration in minutes (optional) - workDayStart: Work day start hour (0-23) (optional) - workDayEnd: Work day end hour (0-23) (optional) - calendar: Calendar name (optional)

Ejemplo: "¿Cuándo estoy libre para una reunión de 1 hora esta semana?"

Obtener el estado de asistente

get_attendee_status - eventId: Event ID - calendar: Calendar name (optional)

Ejemplo: "¿Quién no ha respondido a la invitación a la reunión de mi equipo?"

Nota importante : Al usar operaciones que requieren un ID de evento (update_event, delete_event, get_attendee_status), debe usar el campo id de la respuesta list_events. Este es el EntryID único que Outlook usa para identificar eventos.

Actualizar evento del calendario

update_event - eventId: Event ID to update - subject: New event subject/title (optional) - startDate: New start date in MM/DD/YYYY format (optional) - startTime: New start time in HH:MM AM/PM format (optional) - endDate: New end date in MM/DD/YYYY format (optional) - endTime: New end time in HH:MM AM/PM format (optional) - location: New event location (optional) - body: New event description (optional) - calendar: Calendar name (optional)

Ejemplo: "Actualizar mi reunión de equipo mañana para que comience a las 3 p. m. en lugar de las 2 p. m."

Obtener calendarios

get_calendars

Ejemplo: "Muéstrame mis calendarios disponibles"

Notas de seguridad

  • En el primer uso, Outlook puede mostrar avisos de seguridad para permitir el acceso a scripts.
  • La herramienta solo accede a su cliente Outlook local y no envía datos del calendario a servidores externos
  • Todas las operaciones del calendario se realizan localmente en su computadora

Solución de problemas

  • Avisos de seguridad de Outlook : si ve avisos de seguridad de Outlook, debe permitir que el script acceda a sus datos de Outlook
  • Política de ejecución de scripts : si encuentra errores de ejecución de scripts, es posible que deba ajustar su política de ejecución de PowerShell
  • Problemas de ruta : asegúrese de que la ruta en su archivo de configuración de MCP apunte a la ubicación correcta de la herramienta

Contribuyendo

Agradecemos sus contribuciones a la herramienta MCP del Calendario de Outlook. Consulte nuestra Guía de Contribución para obtener más información sobre cómo empezar.

Al participar en este proyecto, usted acepta cumplir con nuestro Código de conducta .

Licencia

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Tools

El MCP del Calendario de Outlook permite a Claude administrar directamente los calendarios de Microsoft Outlook en sistemas Windows, ofreciendo una solución centrada en la privacidad que mantiene todos los datos locales. Los usuarios pueden ver eventos, crear reuniones, encontrar franjas horarias libres y administrar varios calendarios sin que sus datos salgan de su equipo.

  1. Features
    1. Prerequisites
      1. Installation
        1. Option 1: Install from npm
        2. Option 2: Install from source
      2. MCP Server Configuration
        1. For Claude Desktop App
        2. For Claude VSCode Extension
      3. Usage
        1. List Calendar Events
        2. Create Calendar Event
        3. Find Free Time Slots
        4. Get Attendee Status
        5. Update Calendar Event
        6. Get Calendars
      4. Security Notes
        1. Troubleshooting
          1. Contributing
            1. License

              Related Resources

              Appeared in Searches

              ID: 08enllwrbp