Skip to main content
Glama
Outlook Calendar MCP

Outlook Calendar MCP

by merajmehrabi

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).

Licencia: MIT

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

Related MCP server: Enhanced Outlook MCP Server

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.

Available Tools

7 tools
create_eventC

Create a new calendar event or meeting

Inputs: startDate (required), startTime (required), subject (required), attendees, +6 more.

delete_eventB

Delete a calendar event by its ID

Inputs: eventId (required), calendar.

find_free_slotsC

Find available time slots in the calendar

Inputs: startDate (required), calendar, duration, endDate, +2 more.

get_attendee_statusC

Check the response status of meeting attendees

Inputs: eventId (required), calendar.

get_calendarsB

List available calendars

Inputs: no named parameters.

list_eventsC

List calendar events within a specified date range

Inputs: startDate (required), calendar, endDate.

update_eventC

Update an existing calendar event

Inputs: eventId (required), body, calendar, endDate, +5 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 7 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose with no overlap: create, delete, list, and update events are separate operations, while find_free_slots, get_attendee_status, and get_calendars target unique aspects of calendar management. An agent can easily distinguish between them without confusion.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern using snake_case (e.g., create_event, list_events, get_calendars). The naming is predictable and readable throughout, with no deviations in style or convention.

    Tool Count5/5

    With 7 tools, this server is well-scoped for managing an Outlook calendar. Each tool earns its place by covering essential operations like event CRUD, calendar listing, attendee tracking, and scheduling assistance, avoiding bloat or thin coverage.

    Completeness5/5

    The tool set provides complete CRUD/lifecycle coverage for calendar events (create, list, update, delete) and extends to key domain functions like finding free slots, checking attendee status, and listing calendars. There are no obvious gaps that would hinder agent workflows.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers