8000 Jyoti gmlp 3121 resource and scope by dvlpjrs · Pull Request #144 · gumloop/guMCP · GitHub
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

Jyoti gmlp 3121 resource and scope #144

New issue

Have a question about this project? Sign up for a free GitHub account to open a 8000 n issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 19 commits into from
May 14, 2025
Merged

Jyoti gmlp 3121 resource and scope #144

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
19 commits
Select commit Hold shift + click to select a range
6570e03
attio scopes
dvlpjrs May 12, 2025
4e56a8a
calendly scope
dvlpjrs May 12, 2025
db0e6ff
new resources, output schema, scopes
dvlpjrs May 12, 2025
88963ad
updated resources, added outputschema
dvlpjrs May 12, 2025
2e94985
discourse outputschema, resource update
dvlpjrs May 12, 2025
c67f18b
Merge branch 'main' of https://github.com/gumloop/GumCP into jyoti-gm…
dvlpjrs May 12, 2025
158d003
docusign scope, output format update, outputschema
dvlpjrs May 12, 2025
b219541
oauth fix, outputschema, requredscopes
dvlpjrs May 13, 2025
70584b7
excel
dvlpjrs May 13, 2025
243c113
outptuschema, requiredscopes, test clean up, resource update
dvlpjrs May 13, 2025
c613f7b
fircrawl outputschema
dvlpjrs May 13, 2025
70decc7
temp
dvlpjrs May 13, 2025
4540f02
Merge branch 'main' of https://github.com/gumloop/GumCP into jyoti-gm…
dvlpjrs May 13, 2025
f3e7f8c
gmail
dvlpjrs May 13, 2025
87248ee
temp
dvlpjrs May 14, 2025
1a90ae1
gcal
dvlpjrs May 14, 2025
3baba53
Merge branch 'staging' into jyoti-gmlp-3121-resource-and-scope
dvlpjrs May 14, 2025
b86866e
gdocs
dvlpjrs May 14, 2025
da47d97
Merge branch 'jyoti-gmlp-3121-resource-and-scope' of https://github.c…
dvlpjrs May 14, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions src/servers/gcalendar/config.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,11 @@ name: "Google Calendar guMCP Server"
icon: "assets/icon.png"
description: "Interact with Google Calendar events and schedules"
documentation_path: "README.md"
resources:
- name: "calendars"
description: "Google Calendar calendars and their events"
required_scopes:
- "https://www.googleapis.com/auth/calendar"
tools:
- name: "list_events"
description: "List events from Google Calendar for a specified time range"
Expand All @@ -15,3 +20,15 @@ tools:
description: "Update an existing event in Google Calendar"
required_scopes:
- "https://www.googleapis.com/auth/calendar"
- name: "delete_event"
description: "Delete an event from Google Calendar"
required_scopes:
- "https://www.googleapis.com/auth/calendar"
- name: "update_attendee_status"
description: "Update an attendee's response status for an event"
required_scopes:
- "https://www.googleapis.com/auth/calendar"
- name: "check_free_slots"
description: "Check for available time slots in a calendar"
required_scopes:
- "https://www.googleapis.com/auth/calendar"
274 changes: 262 additions & 12 deletions src/servers/gcalendar/main.py
View file
Open in desktop
F438
Original file line number Diff line number Diff line change
Expand Up @@ -218,11 +218,12 @@ async def handle_list_tools() -> list[Tool]:
},
},
outputSchema={
"type": "string",
"description": "List of calendar events with details including title, ID, time, location, description, and attendees",
"type": "array",
"items": {"type": "string"},
"description": "Each item is a TextContent containing a summary of upcoming events, including count, titles, IDs, times, optional descriptions, and attendees.",
"examples": [
"Found 3 events in the next 7 days:\n\n1. Test Meeting\n ID: <event-id>\n When: 2025-05-14 03:00 to 2025-05-14 04:00\n\n2. Updated Test Meeting\n ID: <event-id>\n When: 2025-05-14 03:00 to 2025-05-14 04:00\n Description: This is a test description\n\n3. No Title\n ID: <event-id>\n When: 2025-05-14 10:00 to 2025-05-14 11:00\n Where: test\n\n"
]
"Found 2 events in the next 7 days:\n\n1. Meeting A\n ID: <ID>\n When: 2025-05-14 09:00 to 2025-05-14 10:00\n\n2. Meeting B\n ID: <ID>\n When: 2025-05-15 11:00 to 2025-05-15 12:00\n Description: <Description>\n Attendees: user@example.com\n"
],
},
requiredScopes=["https://www.googleapis.com/auth/calendar"],
),
Expand Down Expand Up @@ -262,11 +263,12 @@ async def handle_list_tools() -> list[Tool]:
"required": ["summary", "start_datetime", "end_datetime"],
},
outputSchema={
"type": "string",
"description": "Confirmation of event creation with details including title, time, and event ID",
"type": "array",
"items": {"type": "string"},
"description": "Confirmation message for created event, including title, times, optional location, description, attendees, and generated event ID and link.",
"examples": [
"Event created successfully!\nTitle: Test Meeting\nStart: 2025-05-14 10:00\nEnd: 2025-05-14 11:00\n\nEvent ID: <event-id>\nEvent Link: <event-url>"
]
"Event created successfully!\nTitle: <Title>\nStart: <Start>\nEnd: <End>\n\nEvent ID: <ID>\nEvent Link: <URL>"
],
},
requiredScopes=["https://www.googleapis.com/auth/calendar"],
),
Expand Down Expand Up @@ -313,11 +315,135 @@ async def handle_list_tools() -> list[Tool]:
"required": ["event_id"],
},
outputSchema={
"type": "string",
"description": "Confirmation of event update with updated details including title, time, and description",
"type": "array",
"items": {"type": "string"},
"description": "Confirmation message for updated event, including title, updated time range, optional location and description, and event link.",
"examples": [
"Event updated successfully!\nTitle: Updated Test Meeting\nWhen: 2025-05-14 03:00 to 2025-05-14 04:00\nDescription: This is a test description\n\nEvent Link: <event-url>"
]
"Event updated successfully!\nTitle: <Title>\nWhen: <Start> to <End>\nDescription: <Description>\n\nEvent Link: <URL>"
],
},
requiredScopes=["https://www.googleapis.com/auth/calendar"],
),
Tool(
name="delete_event",
description="Delete an event from Google Calendar",
inputSchema={
"type": "object",
"properties": {
"calendar_id": {
"type": "string",
"description": "Calendar ID (optional - defaults to primary)",
},
"event_id": {
"type": "string",
"description": "Event ID to delete",
},
"send_notifications": {
"type": "boolean",
"description": "Whether to send notifications to attendees (optional - defaults to false)",
},
"send_updates": {
"type": "string",
"enum": ["all", "externalOnly", "none"],
"description": "Specifies who should receive notifications (optional - defaults to none)",
},
},
"required": ["event_id"],
},
outputSchema={
"type": "array",
"items": {"type": "string"},
"description": "Empty response indicating successful deletion; a TextContent with an empty string is returned.",
"examples": [""],
},
requiredScopes=["https://www.googleapis.com/auth/calendar"],
),
Tool(
name="update_attendee_status",
description="Update an attendee's response status for an event",
inputSchema={
"type": "object",
"properties": {
"calendar_id": {
"type": "string",
"description": "Calendar ID (optional - defaults to primary)",
},
"event_id": {
"type": "string",
"description": "Event ID to update",
},
"attendee_email": {
"type": "string",
"description": "Email address of the attendee to update",
},
"response_status": {
"type": "string",
"enum": [
"accepted",
"declined",
"tentative",
"needsAction",
],
"description": "New response status for the attendee",
},
"send_notifications": {
"type": "boolean",
"description": "Whether to send notifications to attendees (optional - defaults to false)",
},
"send_updates": {
"type": "string",
"enum": ["all", "externalOnly", "none"],
"description": "Specifies who should receive notifications (optional - defaults to none)",
},
},
"required": ["event_id", "attendee_email", "response_status"],
},
outputSchema={
"type": "array",
"items": {"type": "string"},
"description": "Raw API response for updated attendee status, serialized as a JSON string.",
"examples": [
'{"kind":"calendar#event","id":"<ID>","status":"confirmed","attendees":[{"email":"<EMAIL>","responseStatus":"accepted"}],"htmlLink":"<URL>"}'
],
},
requiredScopes=["https://www.googleapis.com/auth/calendar"],
),
Tool(
name="check_free_slots",
description="Check for available time slots in a calendar",
inputSchema={
"type": "object",
"properties": {
"calendar_id": {
"type": "string",
"description": "Calendar ID (optional - defaults to primary)",
},
"start_datetime": {
"type": "string",
"description": "Start of time range (format: YYYY-MM-DD HH:MM)",
},
"end_datetime": {
"type": "string",
"description": "End of time range (format: YYYY-MM-DD HH:MM)",
},
"duration_minutes": {
"type": "integer",
"description": "Minimum duration of free slots in minutes (optional - defaults to 30)",
},
"timezone": {
"type": "string",
"description": "Timezone for the free slots search (optional - defaults to UTC)",
},
},
"required": ["start_datetime", "end_datetime"],
},
outputSchema={
"type": "array",
"items": {"type": "string"},
"description": "Raw free/busy query response, serialized as a JSON string, detailing busy periods for the specified time range.",
"examples": [
'{"kind":"calendar#freeBusy","timeMin":"<TIME>","timeMax":"<TIME>","calendars":{"primary":{"busy":[{"start":"<TIME>","end":"<TIME>"},...]}}}'
],
},
requiredScopes=["https://www.googleapis.com/auth/calendar"],
),
Expand Down Expand Up @@ -570,6 +696,130 @@ async def handle_call_tool(

return [TextContent(type="text", text=response)]

elif name == "delete_event":
if "event_id" not in arguments:
raise ValueError("Missing required parameter: event_id")

calendar_id = arguments.get("calendar_id", "primary")
event_id = arguments["event_id"]

# Optional parameters
send_notifications = arguments.get("send_notifications", False)
send_updates = arguments.get("send_updates", "none")

# Delete the event
result = (
calendar_service.events()
.delete(
calendarId=calendar_id,
eventId=event_id,
sendNotifications=send_notifications,
sendUpdates=send_updates,
)
.execute()
)

# Return raw API response (usually empty for delete)
return [TextContent(type="text", text=str(result))]

elif name == "update_attendee_status":
if not all(
k in arguments
for k in ["event_id", "attendee_email", "response_status"]
):
raise ValueError(
"Missing required parameters: event_id, attendee_email, response_status"
)

calendar_id = arguments.get("calendar_id", "primary")
event_id = arguments["event_id"]
attendee_email = arguments["attendee_email"]
response_status = arguments["response_status"]

# Optional parameters
send_notifications = arguments.get("send_notifications", False)
send_updates = arguments.get("send_updates", "none")

# First get the existing event
event = (
calendar_service.events()
.get(calendarId=calendar_id, eventId=event_id)
.execute()
)

# Find and update the attendee
attendees = event.get("attendees", [])
found = False

for attendee in attendees:
if attendee.get("email") == attendee_email:
attendee["responseStatus"] = response_status
found = True
break

if not found:
# If attendee not found, add them
if "attendees" not in event:
event["attendees"] = []
event["attendees"].append(
{"email": attendee_email, "responseStatus": response_status}
)

# Update the event
updated_event = (
calendar_service.events()
.update(
calendarId=calendar_id,
eventId=event_id,
body=event,
sendNotifications=send_notifications,
sendUpdates=send_updates,
)
.execute()
)

print(updated_event)

# Return raw API response
return [TextContent(type="text", text=str(updated_event))]

elif name == "check_free_slots":
if not all(k in arguments for k in ["start_datetime", "end_datetime"]):
raise ValueError(
"Missing required parameters: start_datetime, end_datetime"
)

calendar_id = arguments.get("calendar_id", "primary")
duration_minutes = int(arguments.get("duration_minutes", 30))
timezone = arguments.get("timezone", "UTC")

# Process start and end times
start_datetime = arguments["start_datetime"]
end_datetime = arguments["end_datetime"]

# Convert to datetime objects
try:
start_dt = datetime.strptime(start_datetime, "%Y-%m-%d %H:%M")
end_dt = datetime.strptime(end_datetime, "%Y-%m-%d %H:%M")
except ValueError:
raise ValueError("Invalid datetime format. Use YYYY-MM-DD HH:MM")

# Create request body
body = {
"timeMin": start_dt.isoformat() + "Z",
"timeMax": end_dt.isoformat() + "Z",
"timeZone": timezone,
"items": [{"id": calendar_id}],
}

# Make freebusy query
freebusy_response = (
calendar_service.freebusy().query(body=body).execute()
)

# Return raw API response
return [TextContent(type="text", text=str(freebusy_response))]

else:
raise ValueError(f"Unknown tool: {name}")

Expand Down
15 changes: 15 additions & 0 deletions src/servers/gdocs/config.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,12 +2,27 @@ name: "Google Docs guMCP Server"
icon: "assets/icon.png"
description: "Create and manage Google Docs documents"
documentation_path: "README.md"
resources:
- name: "documents"
description: "Google Docs documents created by the user or shared with them"
required_scopes:
- "https://www.googleapis.com/auth/drive.file"
- "https://www.googleapis.com/auth/documents"
tools:
- name: "search_docs"
description: "Search for Google Docs in Drive"
required_scopes:
- "https://www.googleapis.com/auth/drive.file"
- name: "create_doc"
description: "Create a new Google Doc"
required_scopes:
- "https://www.googleapis.com/auth/drive.file"
- "https://www.googleapis.com/auth/documents"
- name: "append_to_doc"
description: "Append content to an existing Google Doc"
required_scopes:
- "https://www.googleapis.com/auth/documents"
- name: "update_doc"
description: "Update content in an existing Google Doc"
required_scopes:
- "https://www.googleapis.com/auth/documents"
Loading
0