Compartir a través de


Referencia de servidor MCP de Calendario de Microsoft Outlook

Importante

Debe formar parte del programa de versión preliminar de Frontier para obtener acceso anticipado a Microsoft Agent 365. Frontier le conecta directamente con las innovaciones de inteligencia artificial más recientes de Microsoft. Las versiones preliminares de Frontier están sujetas a los términos de vista previa existentes en tus acuerdos con clientes. Dado que estas características siguen en desarrollo, su disponibilidad y funcionalidades pueden cambiar con el tiempo.

Información general

Id. de servidor Nombre Descripción
mcp_CalendarTools Servidor MCP de Calendario de Microsoft Outlook Servidor MCP para herramientas de calendario. Use este servidor MCP para operaciones de calendario, como crear, actualizar, recuperar eventos, administrar invitaciones y comprobar la disponibilidad.

Herramientas disponibles

mcp_CalendarTools_graph_acceptEvent

Acepte la invitación de eventos especificada en el calendario de un usuario.

Parámetros requeridos:

  • eventId: el id. del evento que se aceptará.

Parámetros opcionales:

  • userId: id. de usuario o userPrincipalName
  • comentario: texto opcional incluido en la respuesta
  • sendResponse: indica si se enviará respuesta al organizador

mcp_CalendarTools_graph_cancelEvent

Cancele un evento en el calendario de un usuario especificado y notifique a los asistentes.

Parámetros requeridos:

  • eventId: identificador único del evento que se cancelará.

Parámetros opcionales:

  • userId: id. de usuario o userPrincipalName
  • comentario: mensaje de cancelación opcional

mcp_CalendarTools_graph_createEvent

Cree un nuevo evento de calendario en el calendario de un usuario especificado. Admite eventos periódicos y reuniones en línea.

Parámetros requeridos:

  • asunto: asunto/título del evento (no vacío)
  • start: marca de tiempo de inicio con dateTime y timeZone
  • end: marca de tiempo de finalización con dateTime y timeZone
  • attendees_addresses: matriz de direcciones de correo electrónico de asistentes

Parámetros opcionales:

  • userId: id. de usuario o userPrincipalName
  • body: cuerpo del correo electrónico con contentType (Texto/HTML) y contenido
  • location: ubicación con displayName
  • attendees_types: roles de asistente (obligatorio, opcional, recurso)
  • attendees_names: nombres para mostrar de asistentes
  • recurrence: patrón e intervalo de periodicidad
  • isOnlineMeeting: se establece en verdadero para la reunión en línea
  • onlineMeetingProvider: teamsForBusiness, skypeForBusiness, skypeForConsumer
  • allowNewTimeProposals: permitir propuestas de tiempo (valor predeterminado: verdadero)
  • transactionId: identificador de idempotencia

mcp_CalendarTools_graph_declineEvent

Rechace la invitación de eventos especificada en el calendario de un usuario.

Parámetros requeridos:

  • eventId: el id. del evento que se rechazará.

Parámetros opcionales:

  • userId: id. de usuario o userPrincipalName

  • comentario: texto opcional en la respuesta

  • sendResponse: indica si se enviará la respuesta

mcp_CalendarTools_graph_deleteEvent

Elimine un evento del calendario de un usuario especificado.

Parámetros requeridos:

  • eventId: identificador único del evento que se eliminará.

Parámetros opcionales:

  • userId: id. de usuario o userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Sugerir horas y ubicaciones de reunión en función de la disponibilidad del organizador y del asistente.

Parámetros requeridos:

  • meetingDuration: duración de la reunión (por ejemplo, "PT1H")

Parámetros opcionales:

  • userId: id. de organizador o userPrincipalName
  • attendees_addresses: direcciones de correo electrónico de asistentes
  • attendees_types: tipos de asistentes
  • attendees_names: nombres para mostrar de asistentes
  • timeConstraint: disponibilidad de tiempo con franjas horarias y activityDomain
  • locationConstraint: opciones de ubicación
  • maxCandidates: sugerencias máximas
  • isOrganizerOptional: marca opcional de organizador
  • returnSuggestionReasons: incluir razones
  • minimumAttendeePercentage: umbral mínimo de asistencia

mcp_CalendarTools_graph_getEvent

Obtiene un único evento de calendario del calendario de un usuario especificado.

Parámetros requeridos:

  • eventId: identificador único del evento.

Parámetros opcionales:

  • userId: id. de usuario o userPrincipalName
  • select: parámetro de consulta $select OData
  • expand: $expand de OData para las propiedades de navegación

mcp_CalendarTools_graph_getSchedule

Obtenga la programación de disponibilidad de un usuario, lista de distribución o recurso.

Parámetros requeridos:

  • schedules: direcciones SMTP de usuarios o recursos
  • startTime: hora de tiempo de inicio con dateTime y timeZone
  • endTime: hora de finalización con dateTime y timeZone

Parámetros opcionales:

  • userId: id. de usuario o userPrincipalName
  • availabilityViewInterval: duración del espacio de tiempo en minutos

mcp_CalendarTools_graph_listCalendarView

Recupere las apariciones del calendario dentro de un intervalo de tiempo especificado para un usuario.

Parámetros requeridos:

  • startDateTime: inicio del intervalo de tiempo (ISO 8601)
  • endDateTime: fin del intervalo de tiempo (ISO 8601)

Parámetros opcionales:

  • userId: id. de usuario o userPrincipalName
  • top: número máximo de eventos
  • orderby: cláusula Ordenar por

mcp_CalendarTools_graph_listEvents

Recupere una lista de eventos del calendario de un usuario especificado.

Parámetros opcionales:

  • userId: id. de usuario o userPrincipalName
  • startDateTime: inicio del intervalo de tiempo (ISO 8601)
  • endDateTime: fin del intervalo de tiempo (ISO 8601)
  • top: número máximo de eventos
  • filter: consulta de filtro de OData
  • orderby: pedido de OData por consulta

mcp_CalendarTools_graph_updateEvent

Actualice un evento de calendario existente en el calendario de un usuario especificado.

Parámetros requeridos:

  • eventId: identificador único del evento.

Parámetros opcionales:

  • userId: id. de usuario o userPrincipalName
  • subject: asunto actualizado
  • body: contenido del cuerpo actualizado
  • start: hora de inicio actualizada
  • end: hora de finalización actualizada
  • ubicación: ubicación actualizada
  • attendees_addresses: mensajes de correo electrónico de asistentes actualizados
  • attendees_types: tipos de asistentes actualizados
  • attendees_names: nombres de asistentes actualizados
  • isCancelled: se establece en verdadero para cancelar
  • recurrence: patrón de periodicidad actualizado

Características clave

Administración de eventos

  • Crear, leer, actualizar y eliminar eventos
  • Aceptar, rechazar y cancelar invitaciones
  • Compatibilidad con eventos periódicos
  • Integración con reuniones en línea (Teams, Skype)

Disponibilidad y programación

  • Obtener programaciones de libre/ocupado
  • Buscar horas de reunión con comprobación de disponibilidad
  • Vista de calendario con filtrado de intervalo de tiempo
  • Análisis de disponibilidad de asistentes

Administración de asistentes

  • Administrar asistentes a recursos, opcionales y obligatorios
  • Compatibilidad con propuestas de tiempo
  • Seguir respuestas
  • Compatibilidad con listas de distribución

Patrones de periodicidad

  • Patrones diario, semanal, mensual y anual
  • Periodicidad absoluta y relativa
  • Número de fechas de finalización o repetición
  • Especificaciones de día de semana y mes

Reuniones de Internet

  • Integración con Teams para empresas
  • Compatibilidad para Skype Empresarial
  • Compatibilidad para Skype para consumidor
  • Generación automática de vínculos de reunión

Notas

  1. Todas las marcas de tiempo utilizan el formato UTC/ISO 8601 con zona horaria
  2. MCP de Calendario se basa en UserprofileMCP para buscar usuarios en la organización
  3. Las direcciones de correo electrónico deben estar en formato válido
  4. Las matrices de asistentes (direcciones, tipos, nombres) deben estar en el mismo orden
  5. Las reuniones en línea requieren isOnlineMeeting=true y onlineMeetingProvider
  6. La periodicidad requiere objetos de patrón y rango
  7. Las zonas horarias deben ser coherentes en las horas de inicio y finalización
  8. TransactionId habilita la creación de eventos idempotentes