WireCat Google Calendar

Name: WireCat Google Calendar
Author: WireCatLabs

by WireCatLabsversion 0.24.0i★ 3iRuns on your computer

Registry namedev.wirecat/gcal-cli

How to install

What it does

Your Google Calendar for agents: sync, search and change events. Sign in with the gcal CLI first.

Connects Runs on your computer
Account or key No key needed
Category Docs, sheets & office work

Install

Pick the AI app you use, then copy the settings.

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 13, 2026

First: which AI do you use?

ClaudeWeb · app · phoneChatGPTWebClaude CodeTerminalCursorCode editorVS CodeCode editorOtherOther apps

Pick your app and the steps appear below.

Works with Claude, with some setup first

Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Install Node.js
One time only; it works for every server that needs Node.js
Open the Node.js download page ↗
Done
Open the Claude desktop app’s settings file
SettingsDeveloperEdit Config
Done

Paste these settings and save the file

{
  "mcpServers": {
    "gcal-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/gcal-cli",
        "mcp",
        "serve",
        "--profiles",
        "all"
      ]
    }
  }
}

Done

Quit Claude and open it again
Done
Try it
Use WireCat Google Calendar and tell me what you can do for me, then show me one thing
✓ If Claude says it is using WireCat Google Calendar or shows a WireCat Google Calendar tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect WireCat Google Calendar yet

WireCat Google Calendar runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect WireCat Google Calendar

Steps for Claude →Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Steps for Claude Code →Install Node.js on your computer first (one time)
Steps for Cursor →Install Node.js on your computer first (one time)
Steps for VS Code →Install Node.js on your computer first (one time)

B · Others in Docs, sheets & office work that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Puter MCP✓ ChatGPT
LMCP✓ ChatGPT
Keeper.sh✓ ChatGPT

Works with Claude Code, with some setup first

Install Node.js on your computer first (one time)

Install Node.js
One time only; it works for every server that needs Node.js
Open the Node.js download page ↗
Done
Open Terminal
Mac: press Command+Space and type Terminal · Windows: open PowerShell
Done

Paste this command and press Enter

claude mcp add --scope user gcal-cli -- npx -y @wirecat/gcal-cli mcp serve --profiles all

Done

Type /mcp in Claude Code
You should see WireCat Google Calendar listed as connected
Done
Try it
Use WireCat Google Calendar and tell me what you can do for me, then show me one thing
✓ If Claude Code says it is using WireCat Google Calendar or shows a WireCat Google Calendar tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

Install Node.js on your computer first (one time)

Install Node.js
One time only; it works for every server that needs Node.js
Open the Node.js download page ↗
Done
Click this button to open Cursor
Open in Cursor
Cursor asks you to confirm; click Install
Done
Open the AI chat in Cursor in Agent mode
Done
Try it
Use WireCat Google Calendar and tell me what you can do for me, then show me one thing
✓ If Cursor says it is using WireCat Google Calendar or shows a WireCat Google Calendar tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

Install Node.js on your computer first (one time)

Install Node.js
One time only; it works for every server that needs Node.js
Open the Node.js download page ↗
Done
Click this button to open VS Code
Open in VS Code
VS Code asks you to confirm; click Install
Done
Open the AI chat in VS Code in Agent mode
Done
Try it
Use WireCat Google Calendar and tell me what you can do for me, then show me one thing
✓ If VS Code says it is using WireCat Google Calendar or shows a WireCat Google Calendar tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use WireCat Google Calendar💬 Discussion →

For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user gcal-cli -- npx -y @wirecat/gcal-cli mcp serve --profiles all

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "gcal-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/gcal-cli",
        "mcp",
        "serve",
        "--profiles",
        "all"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "gcal-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/gcal-cli",
        "mcp",
        "serve",
        "--profiles",
        "all"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "gcal-cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/gcal-cli",
        "mcp",
        "serve",
        "--profiles",
        "all"
      ]
    }
  }
}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

GitHub stars i: 3
Downloads per weeki: 2,324/wk
Verified domain: ✓ wirecat.dev
Licence i: Apache-2.0
Connection: Runs on your computer
Transport: stdio
Latest versioni: 0.24.0
Categoryi: Docs, sheets & office work
Published to registryi: Nov 13, 2026
Code last changedi: Nov 14, 2026
Maker: WireCatLabs
Packages: npm: @wirecat/gcal-cli
Repo: WireCatLabs/gcal-cli
Website: wirecat.dev
Registry status: Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

All apps, with pros and cons →

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 14, 2026

✓ Pass
Maker matches the repo
The registry name was verified against the domain wirecat.dev (the registry checks domain ownership)
✓ Pass
Still maintained
Code last changed today
✓ Pass
Has a licence
Uses Apache-2.0
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

User reviews

No reviews yet

Compared with others in Docs, sheets & office worki

More stars than 89% of the other 3877 servers in this category
Published to the registry more recently than 94% of the other 3877 servers in this category
Basic checks equal to or better than 100% of the other 3877 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is WireCat Google Calendar safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed today, and the latest version (0.24.0) reached the registry yesterday.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Puter MCP, XcodeBuildMCP, XcodeBuildMCP

Others in the same category

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Puter MCP

Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more

by HeyPuterWidely used★ 44.2KUpdated 5 months ago

Runs in the cloud✓ service owner · puter.com

How to connect

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

by getsentryWidely used↓ 130.5K/wk shared package★ 6.6KUpdated 4 months ago

Runs on your computer✓ service owner · xcodebuildmcp.com

Install

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

by cameroncookeWidely used↓ 130.5K/wk shared package★ 6.6KUpdated 14 months ago

Runs on your computer

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

gcal — Google Calendar CLI for AI agents

Your Google Calendar in the terminal, searchable on your computer, and ready for Claude Code, Codex, Gemini CLI or any agent — within limits you set.

Docs · Use it · WireCat

gcal copies the calendars you own into the local WireCat store. Then you list, show and search events, the people in them and their Drive files, with no network. With write access it also creates, changes, moves and deletes events and answers invitations. A delete asks first. Mailing other people is off until you allow it.

An example conversation (invented people and events, illustrative output):

You:    Use gcal. When can I meet Ana for 30 minutes this week?

Agent: (runs gcal personal calendars busy person:ana@example.com --duration-minutes 30) You both are free on Tuesday 10:00–10:30, Wednesday 14:00–15:00 and Thursday 10:00–12:00. You: Book Tuesday, 30 minutes, "Example planning". Do not email her. Agent: Draft: "Example planning", Tuesday 10:00–10:30, with ana@example.com, no email sent. Create it? You: Yes.

Quick start

You need a Google sign-in client of your own for now. Make one in Google Cloud Console, as a Desktop app, and save its JSON file as ~/client_secret.json with chmod 600.

npm install -g @wirecat/gcal-cli

gcal skill install # the agent skill, for Claude Code, Codex and Gemini CLI gcal personal session start --client-file ~/client_secret.json # sign in to Google in the browser, read-only gcal personal sync # copy the calendars you own, then only what changed gcal personal events list # your events from today on, earliest first

personal is a profile: a name you choose for one Google account. It is the first word of every command that uses an account. A first sync lists a year back and three months ahead. A big one goes on over several runs: run sync again when it says partial.

You need Node.js 22.16 or a later 22.x, or Node.js 24 or later, on macOS, Linux or Windows. Bun also works. Try it without installing: npx @wirecat/gcal-cli --help. If gcal is not found, run gcal doctor. It needs no network and shows what is set up. gcal guide gives step-by-step scenarios.

More: installation (wirecat.dev).

What you can do

See what is coming. "Use gcal. What is on my calendar this week?"

gcal personal events list

Find an event. "When did we plan the roadmap review?" Search runs on the local copy. It matches words, and meaning too once you download a model.

gcal personal search events roadmap planning

Find a time for everyone. Ask Google when people are busy, and get the stretches free for all of them. Nothing is stored.

gcal personal calendars busy person:ana@example.com --duration-minutes 30 --hours 10:00-16:00

Show one event with its attendees, Drive files and history: gcal personal events show event:42.
Link a person to the same person in Telegram, WhatsApp or MAX: gcal personal people link email:ana@example.com telegram:12345.
Create, change and delete events, repeating ones included, and answer invitations. Sign in again with session start --grant write first.
Call any Google Calendar API v3 method by name with gcal api.

More: use it (wirecat.dev).

For AI agents

Your agent. Your calendar. Your rules.

An agent with a terminal — Claude Code, Codex, Gemini CLI, OpenClaw or Hermes Agent. It runs gcal itself. The skill is the agent's instruction sheet: it explains the commands and the limits. gcal skill install writes it.
An app with no terminal — Claude Desktop, Cursor and other MCP clients. Connect the profile's MCP server, gcal personal mcp serve. gcal personal mcp config prints the entry to paste.
ChatGPT or Claude in a browser or on your phone — through your own HTTPS tunnel: gcal personal mcp serve --http. Step by step (wirecat.dev).

gcal skill install                               # for Claude Code, Codex, Gemini CLI and OpenClaw

gcal personal mcp add claude-code --allow-writes # or: codex gcal personal mcp check # start the server once, as the agent will

The server offers writing tools, so mcp add stops until you pass --allow-writes. The profile's permissions decide what an agent may change; gcal personal config set permissions.api readonly keeps it to reads. Text from an invitation is marked untrusted: it is data for the agent, never instructions. Commands that set up the sign-in or the agent link, api call and emptying a calendar are never offered to an agent.

With --json, every command prints one JSON value, and an error comes as JSON with a code to branch on.

More: agents (wirecat.dev), settings and permissions (wirecat.dev).

Why this tool

Your calendar is on your computer. It sits in the same store as the messages, documents and meetings of the other WireCat tools. An agent can answer "what did we agree with Ana" across all of them.
Reads need no network after a sync. A meeting's passcode or PIN is never stored or printed.
Every write is guarded. It never overwrites a change made in Google since the last sync. A delete asks first. It never mails attendees unless you allow it.
Built for agents. A skill, an MCP server, one JSON form and exit codes a script can branch on.

Main features

Incremental sync. After the first sync, sync asks Google only for what changed. gcal personal store status shows how far each calendar is.
Repeating events. Each occurrence is stored one by one, cancelled ones included.
What changed. events list changed_at>=2026-10-25 lists the events that are new, moved or cancelled since a date.
All accounts in one list. events list --source all lists the events of every Google account you signed in to, and says which accounts it read.
Meetings that overlap. events list overlapping:true --source all finds the meetings that clash, also across accounts.
Search by meaning. gcal models download e5-small fetches a small model once. sync --embed then indexes new events with it.
Search in Google. search events --backend server asks Google's own search. It also finds events outside the synced span. --backend both asks the store and Google together.
One search over everything. search all roadmap finds your meetings beside the chats that other WireCat tools stored and your notes, and says which accounts it read.
Every Google Calendar method. gcal api reaches each one, under its own permission key.

Sign-in and profiles

Each profile is one Google account. No command ever picks a profile for you; gcal session list lists them.

gcal personal session start --client-file ~/client_secret.json   # read-only

gcal personal session start --grant write # also create, change and delete events gcal personal session start --grant write,sharing # also see and change who can see a calendar gcal personal session status --check # ask Google whether the sign-in still works

GCAL_PROFILE=personal names the profile for a whole shell session. The sign-in is kept in the system keyring. Where the keyring fails, gcal uses a private file and says so once. It never asks.

More: sign in (wirecat.dev).

Settings and permissions

Settings live in one config.json; gcal personal config show lists them. Permissions say what each command may do: allow, ask, readonly or deny.

Permission	What it covers	Default
`events.create`, `update`, `move`, `respond`	the event writes that are easy to undo	`allow`
`events.delete`	deleting an event	`ask`
`events.notify`	Google mails the other attendees	`deny`
`events.delete.series`	deleting every occurrence of a repeating event	`deny`
`sharing.notify`	Google mails the person a calendar is shared with	`deny`

Sharing a calendar asks first. Over MCP nobody can answer a question, so ask lets a command run. An agent can then share a calendar without asking you. To stop it, run gcal personal config set permissions.api.calendar.acl deny.

gcal personal config set permissions.api readonly                    # reads only, every method

gcal personal config set permissions.events.create ask # ask before each new event gcal personal events create 3 --title 'Example planning' --start-time 2026-11-02T10:00 --end-time 2026-11-02T10:30 --dry-run

--dry-run shows the permission a command needs and does nothing. GCAL_READ_ONLY=1 refuses every write.

More: settings (wirecat.dev).

Limits

Only the calendars you own sync at first. gcal personal calendars list shows the rest, and gcal personal calendars sync 3 adds calendar 3.
gcal has no Google app of its own yet. Sign-in needs your own client.
A Google app in Testing mode ends sign-ins after seven days. Sign in again, or publish the app.
calendars busy shows a person's busy times only when their calendar is shared with you or your organization.
Google's change notifications (watch) are not offered: they need a public web address.

What is planned is on the roadmap (wirecat.dev).

Security

Your event data goes only to Google. The sign-in is kept in the system keyring, or in a file only you can read.
No command, error, log or run record shows a token or the client secret.
A meeting's passcode or P

Only the beginning is shown; read the rest in the repo

WireCat Google Calendar

What it does

Install

Install Node.js

Open the Claude desktop app’s settings file

Paste these settings and save the file

Quit Claude and open it again

Try it

What you can do instead

Install Node.js

Open Terminal

Paste this command and press Enter

Type /mcp in Claude Code

Try it

Install Node.js

Click this button to open Cursor

Open the AI chat in Cursor in Agent mode

Try it

Install Node.js

Click this button to open VS Code

Open the AI chat in VS Code in Agent mode

Try it

Installed on your computer

At a glance

Which apps can use it

Related guides

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Discussion

User reviews

Compared with others in Docs, sheets & office worki

Common questions

Others in the same category

Puter MCP

XcodeBuildMCP

XcodeBuildMCP

README from the maker

gcal — Google Calendar CLI for AI agents

Quick start

What you can do

For AI agents

Why this tool

Main features

Sign-in and profiles

Settings and permissions

Limits

Security