MCP Meet

🚀 mcp-meet

If you, like me, dislike running Google apps locally due to their high battery consumption and prefer native Apple apps, you'll understand that scheduling calendar events with Google Meet can be a real hassle. With mcp-meet, you can simply ask Claude to schedule an event, and it will add the event to your Apple Calendar and generate a Google Meet link.

🚀 Quick Start

If you want to use mcp-meet, please ensure that you meet the prerequisites, complete the installation, and configuration steps. Then you can start using the tool according to the usage section.

✨ Features

• Contact Search: Find people in your Google Contacts by name or email.
• Smart Availability: Check free/busy status across multiple calendars and attendees.
• Common Slots: Find times when everyone is actually available.
• One-Click Scheduling: Automatically find the best slot and book it.
• Google Meet Links: Every meeting comes with a Meet link ready to go.
• Apple Calendar Sync: Meetings automatically appear in your macOS Calendar app.
• Full CRUD Operations: List, view, update, and delete meetings with Google and Apple Calendar sync.

📚 Documentation

How it works

Account Tools

1. list_accounts: List all configured Google accounts with their labels.

Scheduling Tools

2. search_invitees: Search your Google Contacts to find email addresses.
3. find_slots: Get a list of common free time slots across all attendees.
4. create_meet_and_calendar: Create a Google Calendar event with Meet link and mirror to Apple Calendar.
5. plan_and_schedule: The smart one: finds the first available slot that fits your duration and books it instantly.

Meeting Management Tools

6. list_meetings: List all upcoming Google Meet meetings in a time window.
7. get_meeting_details: Get detailed information about a specific meeting by ID.
8. update_meeting: Update meeting title, time, description, or attendees (syncs to Apple Calendar).
9. delete_meeting: Delete a meeting from both Google and Apple Calendar.

📦 Installation

Prerequisites

• Node.js 18 or later.
• A Google Cloud project with Calendar and People API enabled.
• OAuth 2.0 credentials (Client ID and Secret).
• macOS (for Apple Calendar integration).

Installation Steps

You can choose one of the following methods to install mcp-meet:

Method 1: Install via npm

npm install mcp-meet

Method 2: Clone and build from source

git clone https://github.com/znz-systems/mcp-meet.git
cd mcp-meet
pnpm install
pnpm build

Configuration

Create a .env file with your Google OAuth credentials:

GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=your-client-secret
GOOGLE_REDIRECT_URI=http://localhost:5173

# Optional: Specify which calendars to check for availability (comma-separated)
CALENDAR_IDS=primary,your-other-calendar@gmail.com

# Optional: Name of the Apple Calendar to create events in (defaults to "Meetings")
APPLE_CALENDAR_NAME=Work

Google OAuth Setup

1. Go to Google Cloud Console.
2. Create a new project (or select existing).
3. Enable the Google Calendar API and People API.
4. Create OAuth 2.0 credentials (Desktop app type).
5. Add http://localhost:5173 as an authorized redirect URI.
6. Copy your Client ID and Client Secret to your .env file.

First-time authentication

Run the authentication flow to grant access:

pnpm cli auth

This will open your browser for Google sign - in. Once complete, tokens are saved to ~/.config/mcp-meet/tokens.json and you're good to go.

💻 Usage Examples

As an MCP Server

Production Environment

Start the server using stdio transport (for AI assistant integration):

node dist/index.js

Development Environment

pnpm dev

Your MCP client (like Claude Desktop) can then call the available tools.

Claude Desktop / Claude Code Configuration

Add to your MCP settings (claude_desktop_config.json or .mcp.json):

Installed via npx

{
  "mcpServers": {
    "mcp-meet": {
      "command": "npx",
      "args": ["-y", "mcp-meet"]
    }
  }
}

Installed globally

{
  "mcpServers": {
    "mcp-meet": {
      "command": "mcp-meet"
    }
  }
}

📄 License

This project is licensed under the MIT License.

🔗 Badges

🤝 Contributing

Issues and pull requests welcome!