Google Events MCP server

🎭 Google Events API: Event Search in Clean JSON

The most efficient, reliable, and developer-friendly way to use the Google Events API.

Actor page: apify.com/johnvc/google-events-api---access-google-events-data Input schema: apify.com/johnvc/google-events-api---access-google-events-data/input-schema

The Google Events API runs an event search for any query and returns clean, structured JSON. Each page of results comes back with event titles and descriptions, dates and full date/time ranges, venue names with ratings and reviews, multi-line addresses, ticket-provider links (Ticketmaster, Eventbrite, Spotify, and more), map preview images and links, and the filter chips Google offers. It supports location biasing, country and language localization, date and event-type filters, and pagination.

Video Walkthrough

Quick Start

Prerequisites

• Python 3.11 or higher
• An Apify account and API key (get a free key here)

1. Clone the repository

git clone https://github.com/johnisanerd/Apify-Google-Events-API.git
   cd Apify-Google-Events-API

1. Install dependencies with UV

# Install UV if you do not have it:
   curl -LsSf https://astral.sh/uv/install.sh | sh

   # Install project dependencies:
   uv sync

1. Configure your API key

cp .env.example .env
   # Edit .env and add your Apify API key
   # Get your free API key at: https://apify.com?fpr=9n7kx3

1. Run the example

uv run python google-events-api.py

Alternative: set the API key directly

export APIFY_API_TOKEN="your_api_key_here"
uv run python google-events-api.py

Why Use This Google Events API?

Full event detail. Each result includes the title, description, dates, venue (with rating and reviews), address, ticket links from multiple providers, and map links, so you get everything Google Events shows in one structured record.

Aggregated ticket links. Ticket sources like Ticketmaster, Eventbrite, Spotify, AXS, and SeatGeek are collected per event, ready to surface purchase options.

Localized and filterable. Bias by location, localize by country and language (240+ countries, 200+ languages), and filter with Google's own chips: date (today, this week, weekend, month) and event type (virtual).

Predictable, pay-per-use pricing. Billing is per run plus per page processed, with no subscription. You control cost with the page limit.

Easy to automate. Call it from Python in a few lines, or load it as an MCP tool so assistants like Claude and Cursor can find events for you on demand.

Features

Core Capabilities

• Natural-language event search across concerts, conferences, festivals, sports, theater, and virtual events
• Location biasing plus country (gl) and language (hl) localization
• Date and event-type filters via Google's hit chips
• Multi-page pagination with a configurable page cap

Data Quality

• Structured events with title, description, dates, address, and primary link
• Ticket links aggregated from multiple providers
• Venue details with name, rating, and review count
• Map previews (image and Google Maps link) per event
• Per-page metadata and consistent JSON across queries

Usage Examples

Basic search

{
  "q": "concerts in New York",
  "max_pages": 1
}

Localized search

{
  "q": "music festivals",
  "location": "Austin, Texas, United States",
  "gl": "us",
  "hl": "en",
  "max_pages": 2
}

Shortened. The full README is on GitHub.