remote -authless-chat-with-cal

This MCP server provides remote access to your Google Calendar via the MCP (Model Context Protocol) framework, allowing your MCP clients to query calendars, add events, and update existing events without requiring user authentication on the Cloudflare Worker. Once deployed, you can connect to it from compatible MCP clients (like Cursor or Windsurf) using the server URL exposed by Cloudflare. The included example uses a remote tool named mcp-remote, which enables you to forward Calendar operations as MCP tools from your deployed server to your client UI.

To integrate with Claude Desktop or other MCP clients, configure a tool that points to your deployed server’s SSE endpoint. In the provided example configuration, you can create a tool named calculator (or any name you prefer) that launches the mcp-remote utility and targets the server’s /sse endpoint. This makes Calendar queries and mutations available as MCP tools within your client interface.

Prerequisites:

• Node.js and npm installed on your machine
• Access to Cloudflare Workers (wrangler) and an Cloudflare account
• Google Calendar API enabled and a service account with calendar access

Step-by-step:

1. Ensure Node.js and npm are installed

   • Check: node -v and npm -v

2. Create the MCP server project from the template

   • npm create cloudflare@latest -- my-mcp-server --template=cloudflare/ai/demos/remote-mcp-authless

3. Enter the project and install dependencies (if needed)

   • cd my-mcp-server
   • npm install

4. Prepare Google Calendar credentials

   • Create a Google service account and obtain the JSON private key as described in the README
   • Create a .dev.vars file with: GOOGLE_CLIENT_EMAIL="REPLACE-WITH-YOUR-service-account-email" GOOGLE_CALENDAR_ID="REPLACE-WITH-THE-CALENDAR-ID" GOOGLE_PRIVATE_KEY="REPLACE-WITH-PRIVATE-KEY"

5. Deploy secrets to Cloudflare Workers (per README guidance)

   • npx wrangler secret put GOOGLE_CLIENT_EMAIL, then enter the value
   • Repeat for GOOGLE_CALENDAR_ID and GOOGLE_PRIVATE_KEY

6. Deploy the MCP server

   • Ensure wrangler is authenticated with your Cloudflare account
   • wrangler publish

7. Verify deployment

   • Open the deployed URL (e.g., https://remote-mcp-server-authless.your-account.workers.dev/sse) and ensure the MCP server is accessible

Optional: connect Claude Desktop or other MCP clients by adding a tool that points to the server’s SSE endpoint, for example using the provided config snippet that uses mcp-remote to target the server URL.

Tips and caveats:

• The server is designed to operate without user authentication on Cloudflare Workers, relying on a service account for Google Calendar access. Keep your Google service account credentials secure.
• If you modify tools or add new capabilities, update src/index.ts and re-deploy.
• When sharing calendars, ensure the Google Service Account email has the appropriate permissions (Make changes and manage sharing).
• If your deployment URL changes (e.g., after redeploy or account changes), update any client configurations to point to the new SSE endpoint.
• For local testing, you can run the mcp-remote tool against http://localhost:8787/sse if your setup exposes that endpoint during development; otherwise use the deployed URL in production.
• Remember to enable the Google Calendar API in your Google Cloud project before attempting any calendar operations.