1. Access Google Cloud Console through browser;
2. Create new project with descriptive name (e.g., "gcalendar agent");
3. Switch to newly created project once initialization completes.

0. If prompted, click "Configure consent screen";
1. Enter application name (e.g., "calendar mcp");
2. Specify authorized email address;
3. Select "External Audience" for user type restrictions;
4. Provide contact information using the same email;
5. Accept User Data Policy requirements.

1. Navigate to APIs and Services → Library;
2. Search for "Calendar API";
3. Select first result and enable API access;
4. Verify API status shows as "Enabled".

1. Access Credentials section in the APIs and Services;
2. Create OAuth client ID;
3. Select "Desktop Application" as application type;
4. Download generated JSON credentials file;
5. Temporarily store file on Desktop for easy access (optional).

In Claude, copy and paste the following prompt:

Create a new folder named projects in my Documents directory to store all MCP servers.
Then clone the repository using: git clone https://github.com/nspady/google-calendar-mcp.git into that folder.
After cloning, move the file gcp-oauth.keys.json from my Desktop into the cloned repo.

Claude will automatically create the projects folder, clone the repository, move the credentials JSON file into the repo.

• Open your Documents folder;
• Check for a new projects folder;
• Inside, a cloned repo find the new folder(e.g., google-calendar-mcp). The gcp-oauth.keys.json file placed inside the repo.

Run next prompt in Claude:

add next config block to claude config file
    "google-calendar": {
      "command": "npx",
      "args": ["@cocal/google-calendar-mcp"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json"
      }
    }

• Open Settings → shortcut: Cmd + , on Mac or Ctrl + , on Windows;
• Go to the Developer tab → click Edit Config;
• Open claude_desktop_config.json file with text editor. The JSON file should now show the new config block with the correct path to your credentials file;
• If correct, close the config window.

• Fully exit Claude (Mac: Cmd + Q, Windows: Alt + F4);
• Restart the app;
• Upon launch, you'll be redirected to a Google authentication page:
  • Select the same Google account used for the project;
  • When prompted, click Allow to grant access;
  • Once you see authentication successful, close the tab.

In your Terminal (Mac) or Command Line (Windows), start from the root directory (by default) and navigate to the folder where you will store all future AI Agent directories.

• To access a folder, use the command cd folder_name, for example:

cd Documents

To create a new folder, use the command mkdir new_folder_name, for example:

mkdir projects

And navigate to this new folder with the cd command:

cd projects

Use the git clone link command to clone the GitHub repo:

git clone https://github.com/nspady/google-calendar-mcp.git

Move to the newly created repository by using the cd command:

cd google-calendar-mcp

Now you need to move the file with credentials to the folder with the AI agent (google_calendar_mcp). You can do that manually by moving the file icon to the opened folder in the file explorer. Or use Terminal/Command Line and copy the file with the command cp path/to/file_name ., for example:

cp ~/Desktop/gsp-oauth.keys.json .

The dot (.) at the end specifies current directory as destination.

You can check if the JSON file was successfully moved to the folder using the ls command in the Terminal and find the file name in the list.

After moving the file, delete it from its original location (e.g., Desktop).

In the Terminal/Command Line use

npm install

This command downloads all required packages and dependencies.

Continue work in Terminal/Command Line and run

npm start

This command runs the default start script defined in the project's package.json file, which typically launches the application or server, in our case, it launches authentication flow.

1. Browser window opens automatically;
2. Select appropriate Google account;
3. Grant calendar access permissions;
4. Confirm "Authentication successful" message;
5. Close browser window.

Claude Desktop Integration

• Copy configuration block:

    "google-calendar": {
      "command": "node",
      "args": [
        "/path/to/build/index.js"
      ]
    }

• Access Claude config file via Command/Ctrl + , → "Developer" → "Edit Config";
• Open config file claude_desktop_config.json with text editor;
• Add new config as next block after existing configurations and before the two last closing curly brackets;
• Ensure proper JSON syntax with correct bracket closure and commas after each config block except the last one.

In the Terminal/Command Line run

pwd

Copy the full directory path and insert before "/build" in config file.

Save configuration file Command/Ctrl + S.

1. Restart Claude Desktop completely;
2. Verify new server appears in available tools.