🗑️ Google Calendar Cancel Event Actor

A powerful Apify Actor that cancels Google Calendar events with user-friendly credential management. Perfect for voice agents, AI assistants, and MCP (Model Context Protocol) integration.

🌟 Features

• 🔐 Secure Credential Storage: Save Google OAuth credentials once, use across multiple actors
• 🔍 Smart Event Search: Find events by customer info, date range, or specific event ID
• 🚫 Silent Cancellation: Cancel events without sending notifications to attendees
• 🔄 Auto Token Refresh: Automatically handles expired access tokens
• 🤖 AI Agent Ready: Designed for seamless integration with voice agents and MCP servers
• ⚙️ Flexible Confirmation: Choose to cancel first match, all matches, or get interactive confirmation

📋 Table of Contents

• Prerequisites
• Getting Google Calendar Credentials
• Actor Setup
• Usage Examples
• MCP Integration
• Configuration Options
• Troubleshooting

📚 Prerequisites

• Apify Account: Sign up for free
• Google Cloud Project: Create a project
• Google Calendar: Access to the calendar you want to manage

🔑 Getting Google Calendar Credentials

Step 1: Set Up Google Cloud Project

1. Go to Google Cloud Console
2. Create a new project or select an existing one
3. Enable the Calendar API:
   • Navigate to "APIs & Services" → "Library"
   • Search for "Google Calendar API"
   • Click "Enable"

Step 2: Create OAuth 2.0 Credentials

1. Go to "APIs & Services" → "Credentials"
2. Click "Create Credentials" → "OAuth 2.0 Client IDs"
3. Configure OAuth consent screen (if prompted):
   • Choose "External" for testing
   • Fill in required fields (App name, User support email, etc.)
   • Add your email in "Test users" section
4. Create OAuth Client:
   • Application type: "Web application"
   • Name: "Google Calendar Actor"
   • Authorized redirect URIs: https://developers.google.com/oauthplayground
5. Save the Client ID and Client Secret

Step 3: Generate Access and Refresh Tokens

1. Go to Google OAuth 2.0 Playground
2. Click the gear icon (⚙️) in the top right
3. Check "Use your own OAuth credentials"
4. Enter your Client ID and Client Secret from Step 2
5. In "Select & authorize APIs" section:
   • Find "Calendar API v3"
   • Select: https://www.googleapis.com/auth/calendar
   • Click "Authorize APIs"
6. Complete the authorization:
   • Sign in with your Google account
   • Grant calendar permissions
7. Exchange authorization code for tokens:
   • Click "Exchange authorization code for tokens"
   • Copy the access_token and refresh_token

🎯 You should now have all 4 credentials:

✅ Client ID (ends with .googleusercontent.com)
✅ Client Secret (starts with GOCSPX-)
✅ Access Token (starts with ya29.)
✅ Refresh Token (starts with 1//)

🚀 Actor Setup

Step 1: Deploy the Actor

1. Clone this repository
2. Install Apify CLI: npm install -g apify-cli
3. Login to Apify: apify login
4. Deploy the actor: apify push

Step 2: Configure Credentials (One-Time Setup)

1. Go to your Apify Console
2. Find the "Google Calendar Cancel Event" actor
3. Run with ALL credential fields filled:

{
  "googleAccessToken": "ya29.your_access_token_here",
  "googleRefreshToken": "1//your_refresh_token_here",
  "googleClientId": "your_client_id.googleusercontent.com",
  "googleClientSecret": "GOCSPX-your_client_secret_here",
  "eventId": "test_event_id_optional"
}

4. Verify you see: ✅ Credentials saved for future use
5. Your credentials are now stored securely!

💡 Usage Examples

Cancel by Event ID (Recommended)

{
  "eventId": "abc123def456ghi789",
  "calendarId": "primary"
}

Cancel by Customer Search

{
  "customerName": "John Doe",
  "customerEmail": "john@example.com",
  "serviceType": "Consultation",
  "searchCriteria": {
    "timeMin": "2025-08-20T00:00:00Z",
    "timeMax": "2025-08-27T23:59:59Z",
    "maxResults": 10
  },
  "confirmationMode": "first"
}

Cancel with Interactive Confirmation

{
  "customerName": "Jane Smith",
  "searchCriteria": {
    "q": "Meeting with Jane Smith",
    "timeMin": "2025-08-20T00:00:00Z",
    "timeMax": "2025-08-30T23:59:59Z"
  },
  "confirmationMode": "interactive"
}

🤖 MCP Integration

Using with Apify MCP Server

1. Install the Apify MCP Server:

$npm install @anthropic/mcp-server-apify

2. Configure in your MCP client (e.g., Claude Desktop):

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": ["@anthropic/mcp-server-apify"],
      "env": {
        "APIFY_API_TOKEN": "your_apify_token"
      }
    }
  }
}

3. Call the actor via MCP:

{
  "actor": "google-calendar-cancel-event-user-friendly",
  "input": {
    "customerName": "John Doe",
    "searchCriteria": { ... }
  }
}

Voice Agent Integration

Since credentials are stored once, your voice agent only needs to send:

{
  "customerName": "Customer from call",
  "customerPhone": "555-1234",
  "searchCriteria": {
    "timeMin": "2025-08-25T09:00:00Z",
    "timeMax": "2025-08-25T17:00:00Z"
  }
}

⚙️ Configuration Options

Input Parameters

Field	Type	Required	Description
googleAccessToken	String	yes*	OAuth access token (setup only)
googleRefreshToken	String	yes*	OAuth refresh token (setup only)
googleClientId	String	yes*	OAuth client ID (setup only)
googleClientSecret	String	yes*	OAuth client secret (setup only)
customerName	String	No	Customer's name for search
customerPhone	String	No	Customer's phone for search
customerEmail	String	No	Customer's email for search
serviceType	String	No	Service type for search
eventId	String	No	Specific event ID to cancel
searchCriteria	Object	No	Advanced search parameters
calendarId	String	No	Calendar ID (default: "primary")
confirmationMode	String	No	"first", "all", or "interactive"

*Required only for initial credential setup

Search Criteria Object

{
  "q": "search query text",
  "timeMin": "2025-08-20T00:00:00Z",
  "timeMax": "2025-08-27T23:59:59Z",
  "maxResults": 10,
  "singleEvents": true,
  "orderBy": "startTime"
}

Confirmation Modes

• first (default): Cancel the first matching event
• all: Cancel all matching events
• interactive: Return list of events for user confirmation

🛠️ Troubleshooting

Common Issues

1. "No stored Google credentials found"

Solution: Run the actor once with all 4 Google credential fields filled.

2. "Token refresh failed: invalid_client"

Cause: Client ID/Secret don't match the refresh token. Solution:

• If you regenerated Client Secret, get fresh tokens from OAuth Playground
• Ensure all 4 credentials come from the same OAuth flow

3. "Access token may be expired"

Solution: The actor should auto-refresh, but if it fails:

• Check that your refresh token is valid
• Regenerate all credentials if needed

4. "No events found matching criteria"

Solutions:

• Verify the date range includes the event
• Check spelling of customer name/service type
• Try broader search criteria
• Use direct event ID if known

5. Events found but cancellation fails

Check:

• You have "edit" permissions on the calendar
• The event isn't already cancelled
• The event exists in the specified calendar

Debug Mode

Add this to your input for detailed logging:

{
  "debugMode": true,
  ...
}

Credential Validation

To test if your stored credentials work:

{
  "eventId": "nonexistent_id_test",
  "calendarId": "primary"
}

You should get "event not found" rather than authentication errors.

🔒 Security Notes

• Credentials are encrypted in Apify's Key-Value storage
• User isolation: Each Apify user has separate credential storage
• No credential exposure: AI agents never see sensitive tokens
• Automatic token refresh: Reduces need for manual credential updates

📖 Related Actors

• link-to-create-actor: Create new calendar events
• link-to-reschedule-actor: Reschedule existing events

🆘 Support

• Issues: GitHub Issues
• Documentation: Apify Actor Documentation
• Community: Apify Discord

📄 License

Apache-2.0 License - see LICENSE file for details.

---

Made with ❤️ for voice agents and AI automation