MCP Tools Reference: calendarmcp.googleapis.com

টুল: delete_event

প্রদত্ত ক্যালেন্ডার থেকে কোনো ইভেন্ট মুছে ফেলে।

নিম্নলিখিত নমুনাটি দেখায় কিভাবে curl ব্যবহার করে ` delete_event MCP টুলটি চালু করতে হয়।

কার্ল অনুরোধ 
curl --location 'https://calendarmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "delete_event",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

DeleteEvent-এর জন্য অনুরোধ বার্তা।

ডিলিটইভেন্টরিকোয়েস্ট

JSON উপস্থাপনা 
{
  "eventId": string,

  "calendarId": string

  "notificationLevel": enum (NotificationLevel)
}
ক্ষেত্র
eventId

string

আবশ্যক। যে ইভেন্টটি মুছে ফেলতে চান তার আইডি।

ইউনিয়ন ফিল্ড _calendar_id .

_calendar_id নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

calendarId

string

ঐচ্ছিক। যে ক্যালেন্ডারে ইভেন্টটি রয়েছে তার আইডি। ইমেল ঠিকানা - list_calendars ব্যবহার করে এটি খুঁজে পাওয়া যাবে। ডিফল্ট: প্রাথমিক ক্যালেন্ডার।

ইউনিয়ন ফিল্ড _notification_level .

_notification_level নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

notificationLevel

enum ( NotificationLevel )

ঐচ্ছিক। এই ইভেন্ট আপডেটের জন্য কোন ইমেল বিজ্ঞপ্তি পাঠানো হবে।

বিজ্ঞপ্তি স্তর

আপডেট সংক্রান্ত ইমেল বিজ্ঞপ্তির স্তর।

এনাম
NOTIFICATION_LEVEL_UNSPECIFIED ডিফল্ট। ALL হিসেবে গণ্য।
NONE কোনো বিজ্ঞপ্তি নেই।
EXTERNAL_ONLY শুধুমাত্র বহিরাগত অংশগ্রহণকারীদের জন্য।
ALL সকল উপস্থিত ব্যক্তি।

আউটপুট স্কিমা

অনুষ্ঠান

JSON উপস্থাপনা 
{
  "id": string,
  "status": string,
  "htmlLink": string,
  "created": string,
  "updated": string,
  "summary": string,
  "description": string,
  "location": string,
  "creator": {
    object (Principal)
  },
  "organizer": {
    object (Principal)
  },
  "start": {
    object (DateOrDateTime)
  },
  "end": {
    object (DateOrDateTime)
  },
  "recurrence": [
    string
  ],
  "recurringEventId": string,
  "originalStartTime": {
    object (DateOrDateTime)
  },
  "transparency": string,
  "visibility": string,
  "attendees": [
    {
      object (Attendee)
    }
  ],
  "conferenceUrl": string,
  "colorId": string,
  "overrideReminders": [
    {
      object (Reminder)
    }
  ],
  "attachments": [
    {
      object (Attachment)
    }
  ],
  "guestPermissions": {
    object (GuestPermissions)
  },
  "eventType": enum (EventType),
  "workingLocationProperties": {
    object (WorkingLocationProperties)
  },
  "availability": enum (Availability)
}
ক্ষেত্র
id

string

অনন্য শনাক্তকারী।

status

string

ঐচ্ছিক। অবস্থা। সম্ভাব্য মানগুলো হলো:

  • confirmed - ইভেন্টটি নিশ্চিত করা হয়েছে (ডিফল্ট)।
  • tentative - অনুষ্ঠানটি সাময়িকভাবে নিশ্চিত করা হয়েছে।
  • cancelled - ইভেন্টটি বাতিল বা মুছে ফেলা হয়েছে।

htmlLink

string

শুধুমাত্র আউটপুট। গুগল ক্যালেন্ডার ওয়েব UI-তে এই ইভেন্টটির একটি অ্যাবসোলিউট লিঙ্ক।

created

string

শুধুমাত্র আউটপুট। তৈরির সময় (আইএসও ৮৬০১)।

updated

string

শুধুমাত্র আউটপুট। সর্বশেষ পরিবর্তনের সময় (আইএসও ৮৬০১)।

summary

string

শিরোনাম।

description

string

ঐচ্ছিক। বিবরণ। এতে HTML থাকতে পারে।

location

string

ঐচ্ছিক। অবস্থান।

creator

object ( Principal )

শুধুমাত্র আউটপুট। নির্মাতা।

organizer

object ( Principal )

শুধুমাত্র আউটপুট। আয়োজক। উপস্থিত থাকলে অংশগ্রহণকারীদের তালিকাতেও তালিকাভুক্ত থাকবেন।

start

object ( DateOrDateTime )

শুরুর সময় (অন্তর্ভুক্ত)। পুনরাবৃত্তিমূলক ইভেন্টের ক্ষেত্রে প্রথমটি ব্যবহৃত হয়।

end

object ( DateOrDateTime )

শেষ সময় (ব্যতীত)। পুনরাবৃত্তিমূলক ইভেন্টের ক্ষেত্রে প্রথমটি ব্যবহৃত হয়।

recurrence[]

string

পুনরাবৃত্তির নিয়মগুলি RRULE , EXRULE , RDATE , বা EXDATE স্ট্রিং হিসাবে (RFC 5545 অনুযায়ী)। একক ইভেন্টের জন্য এটি বাদ দেওয়া হয়। শুরু/শেষ সময় অবশ্যই start / end ফিল্ডে সেট করতে হবে।

recurringEventId

string

পুনরাবৃত্ত ইভেন্টের দৃষ্টান্তগুলোর মূল পুনরাবৃত্ত ইভেন্ট আইডি।

originalStartTime

object ( DateOrDateTime )

পুনরাবৃত্ত ইনস্ট্যান্সের মূল শুরুর সময়। পুনরাবৃত্তির তথ্য অনুযায়ী এই ইনস্ট্যান্সটি এই সময়েই চালু হবে।

transparency
(deprecated)

string

ঐচ্ছিক। অপ্রচলিত: এর পরিবর্তে availability ব্যবহার করুন।

visibility

string

ঐচ্ছিক। ইভেন্টের দৃশ্যমানতা। সম্ভাব্য মানগুলো হলো:

  • default - ক্যালেন্ডারে ইভেন্টগুলির জন্য ডিফল্ট দৃশ্যমানতা ব্যবহার করে। এটিই ডিফল্ট মান।
  • public – ক্যালেন্ডারের সকল পাঠক ইভেন্টের বিবরণ দেখতে পারেন।
  • private - শুধুমাত্র অনুষ্ঠানে অংশগ্রহণকারীরাই অনুষ্ঠানের বিবরণ দেখতে পারবেন।

attendees[]

object ( Attendee )

উপস্থিত ব্যক্তিরা।

conferenceUrl

string

ভিডিও কনফারেন্স লিঙ্ক।

colorId

string

ইভেন্টের রঙ। এটি শুধুমাত্র আপনার নিজের ক্যালেন্ডার ভিউকে প্রভাবিত করে। এটি ক্যালেন্ডারের কালার প্যালেটের একটি এন্ট্রিকে নির্দেশকারী একটি আইডি (স্ট্রিং '1' - '11' ):

  • 1 : ল্যাভেন্ডার
  • 2 : ঋষি
  • 3 : আঙুর
  • 4 : ফ্লেমিঙ্গো
  • 5 : কলা
  • 6 : ট্যাঞ্জারিন
  • 7 : ময়ূর
  • 8 : গ্রাফাইট
  • 9 : ব্লুবেরি
  • 10 : তুলসী
  • 11 : টমেটো।

overrideReminders[]

object ( Reminder )

অনুস্মারক। সেট করা না থাকলে ক্যালেন্ডারের ডিফল্ট সেটিংসে ফিরে যাবে।

attachments[]

object ( Attachment )

ফাইল সংযুক্তি।

guestPermissions

object ( GuestPermissions )

অতিথির অনুমতি।

eventType

enum ( EventType )

ইভেন্টের ধরণ।

workingLocationProperties

object ( WorkingLocationProperties )

কার্যকরী অবস্থানের বৈশিষ্ট্যসমূহ। শুধুমাত্র যখন event_type WORKING_LOCATION হয়, তখনই এটি পূরণ হয়।

availability

enum ( Availability )

ঐচ্ছিক। প্রাপ্যতা সেটিং।

অধ্যক্ষ

JSON উপস্থাপনা 
{
  "email": string,
  "displayName": string,
  "self": boolean
}
ক্ষেত্র
email

string

ইমেইল।

displayName

string

নাম।

self

boolean

শুধুমাত্র আউটপুট। এই প্রিন্সিপালটি সেই ক্যালেন্ডারের সাথে সঙ্গতিপূর্ণ কিনা যেখানে ইভেন্টের এই অনুলিপিটি প্রদর্শিত হয়। ডিফল্ট: false ।

তারিখ অথবা তারিখ সময়

JSON উপস্থাপনা 
{
  "date": string,
  "dateTime": string,
  "timeZone": string
}
ক্ষেত্র
date

string

UTC মধ্যরাতের ISO 8601 তারিখ (উদাহরণস্বরূপ, '2019-11-20T00:00:00Z' )।

dateTime

string

ISO 8601 টাইমস্ট্যাম্প (উদাহরণস্বরূপ, '2019-11-20T08:19:06-07:00' )।

timeZone

string

TZDB টাইমজোনের নাম।

অংশগ্রহণকারী

JSON উপস্থাপনা 
{

  "id": string

  "email": string

  "displayName": string

  "organizer": boolean

  "self": boolean

  "resource": boolean

  "optionalAttendee": boolean

  "responseStatus": string

  "comment": string

  "additionalGuests": integer
}
ক্ষেত্র

ইউনিয়ন ফিল্ড _id .

_id নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

id

string

শুধুমাত্র আউটপুট। প্রোফাইল আইডি।

ইউনিয়ন ফিল্ড _email .

_email নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

email

string

আবশ্যক। অংশগ্রহণকারীর ইমেইল ঠিকানা।

ইউনিয়ন ফিল্ড _display_name .

_display_name নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

displayName

string

ঐচ্ছিক। নাম।

ইউনিয়ন ফিল্ড _organizer ।

_organizer নিম্নলিখিতদের মধ্যে কেবল একজন হতে পারেন:

organizer

boolean

শুধুমাত্র আউটপুট। অংশগ্রহণকারী আয়োজক কিনা। ডিফল্ট: false ।

ইউনিয়ন ফিল্ড _self .

_self নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

self

boolean

শুধুমাত্র আউটপুট। এই এন্ট্রিটি সেই ক্যালেন্ডারকে প্রতিনিধিত্ব করে কিনা যেখানে ইভেন্টের এই অনুলিপিটি প্রদর্শিত হয়। ডিফল্ট: false ।

ইউনিয়ন ফিল্ড _resource .

_resource নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

resource

boolean

ঐচ্ছিক। অংশগ্রহণকারী একটি রিসোর্স (যেমন, রুম) কিনা। এটি অপরিবর্তনীয়, শুধুমাত্র অংশগ্রহণকারীকে প্রথমবার যুক্ত করার সময় সেট করা যাবে। ডিফল্ট: false ।

ইউনিয়ন ফিল্ড _optional_attendee .

_optional_attendee নিম্নলিখিতদের মধ্যে কেবল একজন হতে পারেন:

optionalAttendee

boolean

ঐচ্ছিক। অংশগ্রহণকারী ঐচ্ছিক কিনা। ডিফল্ট: false ।

ইউনিয়ন ফিল্ড _response_status .

_response_status নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

responseStatus

string

ঐচ্ছিক। প্রতিক্রিয়ার অবস্থা। সম্ভাব্য মানগুলো হলো:

  • needsAction - অংশগ্রহণকারী আমন্ত্রণে সাড়া দেননি (নতুন ইভেন্টের জন্য প্রস্তাবিত)।
  • অংশগ্রহণকারী আমন্ত্রণটি declined করেছেন।
  • tentative - অংশগ্রহণকারী আমন্ত্রণটি অস্থায়ীভাবে গ্রহণ করেছেন।
  • accepted - অংশগ্রহণকারী আমন্ত্রণটি গ্রহণ করেছেন।

ইউনিয়ন ফিল্ড _comment ।

_comment নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

comment

string

শুধুমাত্র আউটপুট। প্রতিক্রিয়ার মন্তব্য।

ইউনিয়ন ফিল্ড _additional_guests ।

_additional_guests নিম্নলিখিতদের মধ্যে কেবল একজনই থাকতে পারবে:

additionalGuests

integer

ঐচ্ছিক। অতিরিক্ত অতিথির সংখ্যা। ডিফল্ট: 0 ।

অনুস্মারক

JSON উপস্থাপনা 
{

  "method": string

  "minutes": integer
}
ক্ষেত্র

ইউনিয়ন ফিল্ড _method .

_method নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

method

string

প্রয়োজনীয়। ডেলিভারি পদ্ধতি। সম্ভাব্য মানগুলো হলো:

  • email - রিমাইন্ডার ইমেইলের মাধ্যমে পাঠানো হয়।
  • popup - রিমাইন্ডারগুলো একটি UI পপআপের মাধ্যমে পাঠানো হয়।

ইউনিয়ন ফিল্ড _minutes ।

_minutes নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

minutes

integer

আবশ্যক। রিমাইন্ডারটি চালু হওয়ার মিনিটখানেক আগে জানাতে হবে।

সংযুক্তি

JSON উপস্থাপনা 
{

  "fileUrl": string

  "title": string
}
ক্ষেত্র

ইউনিয়ন ফিল্ড _file_url .

_file_url নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

fileUrl

string

আবশ্যক। অ্যাটাচমেন্টের ইউআরএল লিঙ্ক।

ইউনিয়ন ফিল্ড _title .

_title নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

title

string

ঐচ্ছিক। সংযুক্তি শিরোনাম।

অতিথি অনুমতি

JSON উপস্থাপনা 
{

  "guestsCanInviteOthers": boolean

  "guestsCanModify": boolean

  "guestsCanSeeGuests": boolean
}
ক্ষেত্র

ইউনিয়ন ফিল্ড _guests_can_invite_others .

_guests_can_invite_others ক্ষেত্রে নিম্নলিখিতগুলির মধ্যে কেবল একটিই হতে পারে:

guestsCanInviteOthers

boolean

ঐচ্ছিক। অতিথিরা অন্যদের আমন্ত্রণ জানাতে পারবেন কিনা।

ইউনিয়ন ফিল্ড _guests_can_modify .

_guests_can_modify নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

guestsCanModify

boolean

ঐচ্ছিক। অতিথিরা অনুষ্ঠানটি পরিবর্তন করতে পারবেন কিনা।

ইউনিয়ন ফিল্ড _guests_can_see_guests .

_guests_can_see_guests ক্ষেত্রে নিম্নলিখিতগুলির মধ্যে কেবল একটিই হতে পারে:

guestsCanSeeGuests

boolean

ঐচ্ছিক। অতিথিরা অন্য অতিথিদের দেখতে পারবেন কি না।

কাজের স্থানের বৈশিষ্ট্য

JSON উপস্থাপনা 
{

  "type": enum (WorkingLocationType)

  "customLocationLabel": string
}
ক্ষেত্র

ইউনিয়ন ফিল্ড _type .

_type নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

type

enum ( WorkingLocationType )

ঐচ্ছিক। কর্মস্থলের ধরণ।

ইউনিয়ন ফিল্ড _custom_location_label .

_custom_location_label নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

customLocationLabel

string

ঐচ্ছিক। নিজস্ব অবস্থানের জন্য লেবেল। ধরন CUSTOM_LOCATION হলে এটি আবশ্যক।

ইভেন্টের ধরণ

ইভেন্টের ধরণ। তৈরির পর অপরিবর্তনীয়।

এনাম
EVENT_TYPE_UNSPECIFIED DEFAULT হিসাবে গণ্য করা হয়েছে।
DEFAULT নিয়মিত ঘটনা। পূর্বনির্ধারিত মান।
OUT_OF_OFFICE অফিসের বাইরের অনুষ্ঠান।
FOCUS_TIME ফোকাস-টাইম ইভেন্ট।
WORKING_LOCATION কর্মস্থলে ঘটা ঘটনা।
BIRTHDAY প্রতি বছর অনুষ্ঠিত হওয়া একটি বিশেষ দিনব্যাপী অনুষ্ঠান।
FROM_GMAIL জিমেইল থেকে আসা ইভেন্ট। এই ধরনের ইভেন্ট তৈরি করা যাবে না।

কাজের স্থানের ধরণ

কর্মস্থলের ধরণ।

এনাম
WORKING_LOCATION_TYPE_UNSPECIFIED অনির্দিষ্ট কর্মস্থলের ধরণ। এটিকে HOME_OFFICE হিসেবে গণ্য করা হবে।
HOME_OFFICE হোম অফিস।
CUSTOM_LOCATION কাস্টম অবস্থান।

প্রাপ্যতা

একটি ইভেন্টের জন্য উপলব্ধতা নির্ধারণ।

এনাম
AVAILABILITY_UNSPECIFIED ডিফল্ট। BUSY হিসেবে গণ্য।
AVAILABILITY_BUSY ক্যালেন্ডারে সময় ব্লক করে।
AVAILABILITY_FREE সময় ব্লক করে না।

টুল টীকা

ধ্বংসাত্মক ইঙ্গিত: ✅ | স্ব-সূচক ইঙ্গিত: ✅ | শুধুমাত্র পঠনযোগ্য ইঙ্গিত: ❌ | উন্মুক্ত বিশ্ব ইঙ্গিত: ❌

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.events