Google Calendar AutoAuth MCP Server

What is Google Calendar AutoAuth MCP Server?

A Model Context Protocol (MCP) server for Google Calendar integration in Claude Desktop with auto authentication support. This server enables AI assistants to manage Google Calendar through natural language interactions.

How to use Google Calendar AutoAuth MCP Server?

Create a Google Cloud Project, enable the Calendar API, and obtain OAuth 2.0 credentials. Place the gcp-oauth.keys.json file in ~/.calendar-mcp/ or your current directory, then run npx @nchufa/calendar auth. Finally, add the server to your Claude Desktop configuration with the command npx @nchufa/calendar.

Key features of Google Calendar AutoAuth MCP Server

• Create, update, and delete calendar events
• Retrieve event details and list events by time range
• Search events by keyword
• List all available calendars
• Support natural language date/time input
• Auto OAuth2 authentication with browser launch

Use cases of Google Calendar AutoAuth MCP Server

• Schedule meetings and appointments via natural language commands
• Manage event details (title, location, attendees) through AI assistants
• Find and filter events using simple queries like “meeting”
• Maintain persistent authentication across sessions

FAQ from Google Calendar AutoAuth MCP Server

How do I authenticate?

Place gcp-oauth.keys.json in either your current directory or ~/.calendar-mcp/, then run npx @nchufa/calendar auth. The server opens a browser for Google OAuth and saves credentials to ~/.calendar-mcp/credentials.json.

Where are credentials stored?

OAuth credentials are stored securely in ~/.calendar-mcp/. The directory holds both the OAuth keys file and the resulting credentials, enabling reuse from any working directory.

What types of OAuth credentials are supported?

Both Desktop app and Web application OAuth 2.0 credentials are supported. For Web applications, ensure the redirect URI http://localhost:3000/oauth2callback is added to the authorized redirect URIs.

What natural language date formats can I use?

Formats include “tomorrow at 2pm”, “next monday”, “2 hours later”, “today”, “now”, and ISO 8601 strings. Combined formats like “monday at 15:30” also work.

How do I configure Claude Desktop?

Add the following to your Claude Desktop configuration file:

{
  "mcpServers": {
    "calendar": {
      "command": "npx",
      "args": ["@nchufa/calendar"]
    }
  }
}