Skip to main content
Glama

gcal-mcp

PyPI CI Release

A Model Context Protocol (MCP) server for Google Calendar that uses OAuth 2.0 with PKCE for secure authentication.

Bring your own Oauth client

To use your own OAuth client credentials:

gcal-mcp --credentials /path/to/credentials.json

Available Tools

3 tools
get_events_for_dateA

Get calendar events for a specific date.

Args: date: Date in YYYY-MM-DD format calendar_id: Calendar ID to query (default: "primary")

Returns: Formatted list of events for that date

Inputs: date (required), calendar_id. Returns: Generic wrapper for non-object return types.

get_upcoming_eventsA

Get upcoming calendar events.

Args: max_results: Maximum number of events to return (default: 10) calendar_id: Calendar ID to query (default: "primary")

Returns: Formatted list of upcoming events with start time and title

Inputs: max_results, calendar_id. Returns: Generic wrapper for non-object return types.

search_eventsA

Search calendar events by keyword.

Args: query: Search term to find in event titles/descriptions max_results: Maximum number of events to return (default: 10) calendar_id: Calendar ID to query (default: "primary")

Returns: Matching events with start time and title

Inputs: query (required), max_results, calendar_id. Returns: Generic wrapper for non-object return types.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 3 tools

    Disambiguation4/5

    The three tools have clearly distinct purposes: retrieving events for a specific date, listing upcoming events, and searching by keyword. Some overlap exists (e.g., upcoming events could be retrieved by date), but the descriptions differentiate them well.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with snake_case: get_events_for_date, get_upcoming_events, search_events. The pattern is predictable and easy to understand.

    Tool Count2/5

    With only 3 tools, the server feels under-scoped for a calendar service. Most calendar servers provide create, update, delete, and calendar management operations, which are missing here.

    Completeness2/5

    The server only covers read/query operations (get, list, search). It lacks any write operations (create, update, delete events) or calendar management, leaving significant gaps for common workflows.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers