Bagikan melalui


Referensi server Microsoft Kalender Outlook MCP

Penting

Anda harus menjadi bagian dari program pratinjau Frontier untuk mendapatkan akses awal ke Microsoft Agent 365. Frontier menghubungkan Anda langsung dengan inovasi AI terbaru Microsoft. Pratinjau frontier tunduk pada ketentuan pratinjau yang ada dari perjanjian pelanggan Anda. Karena fitur-fitur ini masih dalam pengembangan, ketersediaan dan kemampuannya dapat berubah dari waktu ke waktu.

Ikhtisar

ID Penjual Nama tampilan KETERANGAN
mcp_CalendarTools Microsoft Kalender Outlook MCP Server Server MCP untuk alat kalender. Gunakan server MCP ini untuk operasi kalender seperti membuat, memperbarui, mengambil peristiwa, mengelola undangan, dan memeriksa ketersediaan.

Alat yang tersedia

mcp_CalendarTools_graph_acceptEvent

Terima undangan acara yang ditentukan di kalender pengguna.

Parameter yang diperlukan

  • eventId: ID acara yang akan diterima

Parameter opsional

  • userId: ID Pengguna atau userPrincipalName
  • komentar: Teks opsional disertakan dalam respons
  • sendResponse: Apakah akan mengirim respons ke penyelenggara

mcp_CalendarTools_graph_cancelEvent

Batalkan acara di kalender pengguna tertentu dan beri tahu peserta.

Parameter yang diperlukan

  • eventId: Pengidentifikasi unik peristiwa yang akan dibatalkan

Parameter opsional

  • userId: ID Pengguna atau userPrincipalName
  • komentar: Pesan pembatalan opsional

mcp_CalendarTools_graph_createEvent

Buat acara kalender baru di kalender pengguna tertentu. Mendukung acara berulang dan rapat online.

Parameter yang diperlukan

  • subjek: Subjek/judul peristiwa (tidak kosong)
  • mulai: Mulai tanda waktu dengan dateTime dan timeZone
  • end: Akhiri tanda waktu dengan dateTime dan timeZone
  • attendees_addresses: Array alamat email peserta

Parameter opsional

  • userId: ID Pengguna atau userPrincipalName
  • isi: Isi peristiwa dengan contentType (Teks/HTML) dan konten
  • lokasi: Lokasi dengan displayName
  • attendees_types: Peran peserta (diperlukan, opsional, sumber daya)
  • attendees_names: Nama tampilan peserta
  • pengulangan: Pola dan rentang pengulangan
  • isOnlineMeeting: Atur ke true untuk rapat online
  • onlineMeetingProvider: teamsForBusiness, skypeForBusiness, skypeForConsumer
  • allowNewTimeProposals: Izinkan proposal waktu (default: true)
  • transactionId: Pengidentifikasi idempotensi

mcp_CalendarTools_graph_declineEvent

Tolak undangan acara yang ditentukan di kalender pengguna.

Parameter yang diperlukan

  • eventId: ID peristiwa yang akan ditolak

Parameter opsional

  • userId: ID Pengguna atau userPrincipalName

  • komentar: Teks opsional sebagai respons

  • sendResponse: Apakah akan mengirim respons

mcp_CalendarTools_graph_deleteEvent

Menghapus acara dari kalender pengguna tertentu.

Parameter yang diperlukan

  • eventId: Pengidentifikasi unik peristiwa yang akan dihapus

Parameter opsional

  • userId: ID Pengguna atau userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Sarankan waktu rapat dan lokasi berdasarkan ketersediaan penyelenggara dan peserta.

Parameter yang diperlukan

  • meetingDuration: Durasi rapat (misalnya, 'PT1H')

Parameter opsional

  • userId: ID Pengelola atau userPrincipalName
  • attendees_addresses: Alamat email peserta
  • attendees_types: Jenis peserta
  • attendees_names: Nama tampilan peserta
  • timeConstraint: Ketersediaan waktu dengan timeslots dan activityDomain
  • locationConstraint: Opsi lokasi
  • maxCandidates: Saran maksimum
  • isOrganizerOptional: Pengatur bendera opsional
  • returnSuggestionReasons: Menyertakan alasan
  • minimumAttendeePercentage: Ambang batas kehadiran minimum

mcp_CalendarTools_graph_getEvent

Dapatkan satu acara kalender dari kalender pengguna tertentu.

Parameter yang diperlukan

  • eventId: Pengidentifikasi unik peristiwa

Parameter opsional

  • userId: ID Pengguna atau userPrincipalName
  • pilih: Parameter kueri $select OData
  • perluas: $expand OData untuk properti navigasi

mcp_CalendarTools_graph_getSchedule

Dapatkan jadwal bebas/sibuk untuk pengguna, daftar distribusi, atau sumber daya.

Parameter yang diperlukan

  • jadwal: Alamat SMTP pengguna atau sumber daya
  • startTime: Waktu mulai dengan dateTime dan timeZone
  • endTime: Waktu selesai dengan dateTime dan timeZone

Parameter opsional

  • userId: ID Pengguna atau userPrincipalName
  • availabilityViewInterval: Panjang slot waktu dalam menit

mcp_CalendarTools_graph_listCalendarView

Mengambil kemunculan kalender dalam rentang waktu tertentu untuk pengguna.

Parameter yang diperlukan

  • startDateTime: Rentang waktu mulai (ISO 8601)
  • endDateTime: Akhir rentang waktu (ISO 8601)

Parameter opsional

  • userId: ID Pengguna atau userPrincipalName
  • teratas: Jumlah maksimum peristiwa
  • orderby: Urutan berdasarkan klausa

mcp_CalendarTools_graph_listEvents

Ambil daftar acara dari kalender pengguna tertentu.

Parameter opsional

  • userId: ID Pengguna atau userPrincipalName
  • startDateTime: Rentang waktu mulai (ISO 8601)
  • endDateTime: Akhir rentang waktu (ISO 8601)
  • atas: Jumlah maksimum peristiwa
  • filter: Kueri filter OData
  • orderby: Urutan OData menurut kueri

mcp_CalendarTools_graph_updateEvent

Perbarui acara kalender yang sudah ada di kalender pengguna tertentu.

Parameter yang diperlukan

  • eventId: Pengidentifikasi unik peristiwa

Parameter opsional

  • userId: ID Pengguna atau userPrincipalName
  • subjek: Subjek yang diperbarui
  • isi: Konten isi yang diperbarui
  • mulai: Waktu mulai yang diperbarui
  • akhir: Waktu akhir yang diperbarui
  • lokasi: Lokasi yang diperbarui
  • attendees_addresses: Email peserta yang diperbarui
  • attendees_types: Jenis peserta yang diperbarui
  • attendees_names: Nama peserta yang diperbarui
  • isCancelled: Atur ke true untuk membatalkan
  • pengulangan: Pola pengulangan yang diperbarui

Fitur utama

Manajemen acara

  • Membuat, membaca, memperbarui, Hapus
  • Menerima, menolak, dan membatalkan undangan
  • Dukungan untuk peristiwa berulang
  • Integrasi dengan rapat online (Teams, Skype)

Ketersediaan dan penjadwalan

  • Dapatkan jadwal bebas/sibuk
  • Menemukan waktu rapat dengan pemeriksaan ketersediaan
  • Tampilan kalender dengan pemfilteran rentang waktu
  • Analisis ketersediaan peserta

Manajemen peserta

  • Mengelola peserta yang diperlukan, opsional, dan sumber daya
  • Dukungan untuk proposal waktu
  • Melacak respons
  • Dukungan untuk daftar distribusi

Pola Pengulangan

  • Pola harian, mingguan, bulanan, dan tahunan
  • Pengulangan absolut dan relatif
  • Tanggal akhir atau jumlah kemunculan
  • Spesifikasi hari dalam seminggu dan bulan

Rapat Online

  • Integrasi dengan Teams for Business
  • Dukungan untuk Skype for Business
  • Dukungan untuk Skype for Consumer
  • Pembuatan tautan rapat otomatis

Catatan

  1. Semua tanda waktu menggunakan format UTC/ISO 8601 dengan zona waktu
  2. MCP Kalender mengandalkan UserprofileMCP untuk menemukan pengguna di organisasi
  3. Format email harus valid.
  4. Array peserta (alamat, jenis, nama) harus dalam urutan yang sama
  5. Rapat online memerlukan isOnlineMeeting=true dan onlineMeetingProvider
  6. Pengulangan memerlukan objek pola dan rentang
  7. Zona waktu harus konsisten di seluruh waktu mulai dan berakhir
  8. TransactionId memungkinkan pembuatan peristiwa idempogen