gct-mcp
Provides tools for managing Google Calendar: listing, creating, updating, moving, and deleting events, quick-adding events, checking free/busy time for scheduling, and full management of calendars, calendar list subscriptions, ACL sharing rules, colors, and settings.
Provides tools for managing Google Tasks: creating, updating, completing, reopening, moving, and deleting tasks (including subtasks in outline order), bulk-clearing completed tasks, and managing task lists. Also serves an interactive kanban task board UI whose columns are driven by status tags in task notes.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
google-calendar-tasks
Google Calendar と Google Tasks を Claude から扱うための MCP サーバーと CLI。
pnpm workspaces の monorepo。Google API を叩くサービス層(packages/core)を runtime 非依存(fetch のみ)で作り、それを CLI(Node)と MCP サーバー(Cloudflare Workers)の両方から使っています。
packages/core Calendar / Tasks のサービス層(neverthrow ResultAsync + zod、runtime 非依存)
packages/cli `gct` CLI(gunshi、OAuth loopback + PKCE、トークンは ~/.config/gct に保存)
apps/mcp MCP サーバー(Hono on Cloudflare Workers、Cloudflare Access 配下)できること
Claude のチャットから、こんな頼み方で使えます。
「今日と明日の予定と、期限切れのタスクをまとめて」
「来週火曜 15 時から 1 時間『定例』を入れて。Meet 付きで」
「来週の空き時間を出して」
「タスクボード見せて」 → カンバンが会話の中に表示され、ドラッグで状態を変えられます
「『引っ越しの準備』を進行中にして」
「日常タスクの完了済みを片付けて」
MCP ツール(44 個)
分類 | ツール |
予定 |
|
空き時間 |
|
カレンダー |
|
カレンダーリスト |
|
共有(ACL) |
|
色・設定 |
|
タスク |
|
タスクリスト |
|
MCP App |
|
設計方針
読み出しは正規化:LLM が次の呼び出しにそのまま使えるよう、id を必ず含め、時刻はオフセット付きで返し、etag などのノイズは落とします。
list_tasksは親タスクの直後にサブタスクが並ぶアウトライン順で、depthとparentIdを持ちます。書き込みは厳格:不正な入力は推測で補わずに拒否し、何が悪いか・正しい形式・次に呼ぶツールをエラーで返します。
破壊的な操作は明示的:削除は更新とは別の専用ツールに分けています。カレンダーの全予定削除(
clear_calendar)、完了済みタスクの一括非表示(clear_completed_tasks)、owner 権限での共有には、確認用のconfirm引数を必須にしています。通知は既定でしない:
sendUpdatesを指定しない限り、参加者にメールは飛びません。
タスクボードと状態タグ
show_task_board は MCP Apps の UI(ui://gct/task-board.html)を返し、Claude の会話の中にカンバンを描画します。列(todo / doing / done)は、タスクのメモの 1 行目にあるタグで決まります。
[status: doing]
ここから下は普通のメモタグがなければ todo、Google 側で完了済みなら done として扱います。
ボードでカードを移動するか
set_task_statusを呼ぶと、タグが書き換わります。done に移すと Google 側でも完了になります。Google Tasks アプリでメモの 1 行目を直接書き換えても反映されます。
Related MCP server: Google Calendar MCP Server
MCP サーバーの構成
Claude ──▶ Cloudflare MCP Server Portal ──▶ Cloudflare Access ──▶ Worker (/mcp)
│ Access JWT の email で
▼ Durable Object を選ぶ
GoogleTokenStore (SQLite DO)
│ refresh token
▼
Google Calendar / Tasks API利用者の認証は Cloudflare Access が行い、Worker は
Cf-Access-Jwt-Assertionを検証して email を得ます。Access は IdP の Google トークンを origin に渡さないため、Google API 用の OAuth は Worker が別に持ちます(
/google/connect→/google/callback)。refresh token は email ごとの Durable Object に保存します。ツールは Calendar(予定・カレンダー・ACL・freebusy など)と Tasks(タスク・タスクリスト)をほぼ全 API カバーしています。読み出しは LLM 向けに正規化し、書き込みは不正な入力を推測で補わずに拒否します。
show_task_boardは MCP Apps のカンバンボードを返します。列はタスクのメモ 1 行目のタグ[status: todo|doing|done]で決まります。サーバーの
instructionsで既定(Asia/Tokyo、参加者への通知は明示時のみ、既定タスクリストDEFAULT_TASK_LIST)をクライアントに伝えます。
Tech Stack
領域 | 採用技術 |
MCP |
|
Server | Hono on Cloudflare Workers + Durable Objects( |
CLI | gunshi + tsx |
Errors / Async | neverthrow + error classes |
Validation | |
Dates | dayjs(utc + timezone) |
Build | tsdown(auto exports) |
Lint / Format | oxlint + oxfmt |
Type Check | |
Test |
Setup
pnpm installGoogle Cloud
Google Cloud のプロジェクトで Google Calendar API と Google Tasks API を有効にします。
OAuth 同意画面を作り、スコープ
https://www.googleapis.com/auth/calendarとhttps://www.googleapis.com/auth/tasksを追加します。テスト中のままだと refresh token が 7 日で切れるので、使い続けるなら本番に公開します。OAuth クライアントを用途ごとに作ります。
CLI 用:デスクトップ アプリ
MCP サーバー用:ウェブ アプリケーション。承認済みリダイレクト URI に
https://<host>/google/callbackを登録します。
CLI
cp packages/cli/.env.example packages/cli/.env # GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET を記入
pnpm cli login # ブラウザで Google にログイン(loopback + PKCE)
pnpm cli events list
pnpm cli tasks listコマンド | 内容 |
| ログイン、トークンの失効と削除、状態の確認 |
| カレンダー一覧 |
| 予定の一覧・表示・作成・更新・削除 |
| 空き時間の確認 |
| タスクリストの一覧・追加・名前変更・削除 |
| タスクの一覧・追加・更新・完了・再開・削除 |
各コマンドの詳細は pnpm cli <command> --help で確認できます。
MCP サーバー
Cloudflare Zero Trust で、Worker のホスト(例:
gct.example.com)全体を守る self-hosted の Access アプリを作り、AUD タグを控えます。apps/mcp/cloudflare.config.tsに、mode(staging/production)ごとの Worker 名・ドメイン・Access の team / AUD・リダイレクト URI と、Google OAuth クライアント(ウェブ アプリ)の id を書きます。client secret を Worker secret
GOOGLE_CLIENT_SECRETとして設定します。ローカル開発ではapps/mcp/.dev.varsに置きます(gitignore 済み)。デプロイします。
pnpm --filter @napolab/gct-mcp deploy:staging pnpm --filter @napolab/gct-mcp deploy:productionブラウザで
https://<host>/を開き、Connect Google から Google を接続します。Cloudflare の MCP Server Portal に
https://<host>/mcpを MCP サーバーとして登録し、Claude からは Portal の URL をコネクタとして追加します。
環境変数 | 内容 |
| Access JWT の検証に使う team と AUD |
| Worker 用の Google OAuth クライアント |
| 同上の secret(Worker secret) |
|
|
Scripts
Command | Description |
| oxfmt --check + oxlint |
| oxfmt --write + oxlint --fix |
| tsgo --noEmit |
| vitest run --typecheck |
| tsdown(package.json の exports を生成) |
| CLI をソースから実行 |
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Simple kanban for small teams. Read and update your Moxboard boards and tasks from Claude.
Lets Claude, ChatGPT, and Muse read and update your beckett tasks, notes, calendar, and lists.
Multiple Google accounts (Gmail, Calendar, Drive, Contacts, Tasks) in one Claude connector.
Multiple Google accounts (Gmail, Calendar, Drive, Contacts, Tasks) in one Claude connector.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAllows interaction with Google Calendar through Claude Desktop using the Model Context Protocol, enabling calendar event management and schedule analysis.2-
- AlicenseNot gradedqualityDmaintenanceEnables Claude to interact with Google Calendar through natural language, providing the ability to view, create, update, and delete calendar events with persistent OAuth2 authentication.22 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude to interact with Google Calendar through OAuth authentication, allowing users to list events, create and manage meetings, update or delete calendar entries, and find available time slots using natural language.72MIT
- FlicenseBqualityDmaintenanceEnables Claude to manage Google Calendar events, schedules, and meetings through natural conversation. It supports viewing calendars, creating Google Meet events, and searching for upcoming activities using Nango for authentication.6-