aiden-gsuite 0.1.0

MCP Server to connect to Google G-Suite

aiden-gsuite MCP server

This project is based on mcp-gsuite

MCP server to interact with Google products. With Aiden, Google account authorization is extremely simplified.

Example prompts

Right now, this MCP server supports Gmail and Calendar integration with the following capabilities:

1. General

• Multiple google accounts

2. Gmail

• Get your Gmail user information
• Query emails with flexible search (e.g., unread, from specific senders, date ranges, with attachments)
• Retrieve complete email content by ID
• Create new draft emails with recipients, subject, body and CC options
• Delete draft emails
• Reply to existing emails (can either send immediately or save as draft)
• Retrieve multiple emails at once by their IDs.
• Save multiple attachments from emails to your local system.

3. Calendar

• Manage multiple calendars
• Get calendar events within specified time ranges
• Create calendar events with:
  • Title, start/end times
  • Optional location and description
  • Optional attendees
  • Custom timezone support
  • Notification preferences
• Delete calendar events

Example prompts you can try:

• Retrieve my latest unread messages

• Search my emails from the Scrum Master

• Retrieve all emails from accounting

• Take the email about ABC and summarize it

• Write a nice response to Alice's last email and upload a draft.

• Reply to Bob's email with a Thank you note. Store it as draft

• What do I have on my agenda tomorrow?

• Check my private account's Family agenda for next week

• I need to plan an event with Tim for 2hrs next week. Suggest some time slots.

Quickstart

Install

No credential file needed.

"aiden-gsuite": {
  "command": "uv",
  "args": [
    "--directory",
    "path/to/aiden-gsuite",
    "run",
    "aiden-gsuite"
  ],
  "credential": {
    "type": "oauth",
    "service": "google",
    "scopes": [
      "openid",
      "https://mail.google.com/",
      "https://www.googleapis.com/auth/calendar",
      "https://www.googleapis.com/auth/userinfo.email"
    ]
  },
  "transport": "stdio",
}

Debugging

Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the MCP Inspector.

You can launch the MCP Inspector via npm with this command:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-gsuite run aiden-gsuite

Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.