What is Mcp Gmail Calendar Ai Agent

mcp-gmail-calendar-ai-agent is a smart service that monitors your Gmail for deadlines or scheduled events and automatically creates corresponding Google Calendar entries using Composio and LangChain.

Use cases

Use cases include automatically adding meetings or deadlines from emails to Google Calendar, enhancing personal organization, and streamlining workflow for professionals.

How to use

To use mcp-gmail-calendar-ai-agent, clone the repository, install the required packages, configure your API keys, enable the Gmail trigger, run the server, and send a test email with a deadline or event.

Key features

Key features include automated triggers for new Gmail messages, deadline extraction using a language model agent, automatic Google Calendar integration for creating events, and one-step run scripts for easy setup.

Where to use

mcp-gmail-calendar-ai-agent can be used in personal productivity, project management, and any scenario where tracking deadlines and scheduling events is essential.

Deadline-Notifier

A smart, zero-config service that watches your Gmail for deadlines or scheduled events and instantly creates Google Calendar entries via Composio + LangChain.

Features

• 🤖 Automated triggers – uses Composio MCP to fire on every new Gmail message

• 📧 Deadline extraction – LLM agent identifies dates/times in your email body

• 📅 Calendar integration – automatically creates a Google Calendar event when a deadline or meeting is found

• 🔧 One-step run scripts –

  • runserver.py to bootstrap MCP connection
  • run_code.py to spin up your FastAPI webhook

Quickstart

1. Clone & install

git clone https://github.com/your-org/deadline-notifier.git
cd deadline-notifier
pip install -r requirements.txt

2. Configure your API keys

Create a .env in the project root:

COMPOSIO_API_KEY=your_composio_key

3. Enable the Gmail trigger

python mcp_client.py
# You should see: "enabled"

4. Run your server & expose via ngrok

Step A :

# Start your webhook & ngrok in separate terminals
ngrok http 8000

1. Copy the https://…ngrok.io URL.
2. Paste it into your Composio dashboard under your Gmail trigger’s “webhook URL.”
3. Restart python run_code.py.

Step B (Execute the fastapi application):

uvicorn app:app --port 8000 --reload

5. Send yourself a test email

Include a phrase like:

“Let’s meet March 14 at 3 PM to review the Q1 plan.”

Within seconds you’ll see in your console:

[MCP] { … }
[APP] 📧 Message ID: abc123…
[APP] Event created successfully on Google Calendar

File Overview

• app.py — FastAPI webhook that listens for Gmail-new-message events
• gmail_service.py — LangChain agent to fetch & parse email content
• calendar_service.py — LangChain agent to create Google Calendar events
• mcp_client.py — Enables the Gmail trigger in your Composio entity
• runserver.py — Convenience script: runs mcp_client.py then ngrok http 8000
• run_code.py — Convenience script: runs uvicorn on your FastAPI app