Google Business Profile Review MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to manage Google Business Profile reviews through intelligent automation.

Features

• Review Management: Fetch and analyze Google Business Profile reviews
• AI-Powered Responses: Generate contextually appropriate replies using LLM sampling
• Automated Posting: Post replies back to Google Business Profile
• OAuth Integration: Secure authentication with Google APIs
• Rate Limiting: Respectful API usage with built-in rate limiting
• Structured Logging: Comprehensive logging for debugging and monitoring

Prerequisites

• Node.js 18.0.0 or higher
• Google Cloud Platform account with My Business API enabled
• Google OAuth 2.0 credentials
• Google Business Profile API Access (see requirements below)

Google Business Profile API Access Requirements

Before you can use this MCP server, you must request and be approved for Google Business Profile API access. Google requires all applicants to:

1. Manage a verified Google Business Profile that has been active for 60+ days
   • This can be your own business or a client’s business you manage
2. Have a website representing the business listed on the Google Business Profile
3. Complete Google Business Profile with current, up-to-date information

To request API access:

1. Go to the Google Cloud Console and note your Project Number from the Project info card
2. Submit your request using the GBP API contact form
   • Select “Application for Basic API Access” from the dropdown
   • Provide your Project Number and all requested information
   • Use an email address listed as an owner/manager on your business’s GBP
3. Wait for review - you’ll receive a follow-up email with the decision

Check approval status by viewing quotas in Google Cloud Console:

• 0 QPM (Queries Per Minute) = Not yet approved
• 300 QPM = Approved ✓

For complete prerequisites, see the official GBP API documentation.

Setup

1. Google Cloud Configuration

1. Go to the Google Cloud Console
2. Create a new project or select an existing one
3. Request GBP API access (see requirements above - this step is critical and may take time for approval)
4. Enable the following APIs (after your project is approved):
   • Go to “APIs & Services” > “Library”
   • Search for and enable “Google My Business API”
   • Search for and enable “My Business Account Management API”
5. Create OAuth 2.0 credentials:
   • Go to “Credentials” in the API & Services section
   • Click “Create Credentials” > “OAuth 2.0 Client IDs”
   • Set application type to “Web application”
   • Add authorized redirect URI: http://localhost:3000/auth/callback