ai-scheduler-mcp
About
google tasks apiとgoogle calendar apiを利用したスケジューリング用のsse対応のmcp server
Details
- Author
- torohash
- Downloads
- 164
- Categories
- Other
Jump to
- Integrates Google Tasks and Calendar APIs
- Runs in a Docker container
- Uses SSE (Server-Sent Events) transport
- Configurable via environment variables and command options
- Provides a management script for build, start, stop, logs, and delete
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
ai-scheduler-mcpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Set up a Docker network named mcp-network, obtain OAuth 2.0 credentials from Google Cloud Console, download credentials.json, build the Docker image using the provided script, run initial authentication to generate token.json, then start the server with ai_scheduler_mcp start. Connect your MCP client to the SSE endpoint at http://localhost:<PORT>/sse.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"ai-scheduler-mcp": {
"ai-scheduler-mcp": {
"command": "docker",
"args": [
"network",
"create",
"mcp-network"
]
}
}
}
}McpServers
{
"ai-scheduler-mcp": {
"command": "docker",
"args": [
"network",
"create",
"mcp-network"
]
}
}ai-scheduler-mcp
Google Tasks と Calendar API を統合するための MCP（Model Context Protocol）サーバーです。MCPクライアント（Roo Codeなど）から Google Tasks と Calendar の機能を利用できます。
前提条件
- Docker がインストールされていること。
- mcp-network という名前の Docker ネットワークが存在すること。
# 存在しない場合、以下のコマンドで作成
docker network create mcp-network
セットアップ
1. リポジトリの準備:
このリポジトリをクローンまたはダウンロードします。
2. 認証情報 (credentials.json) の準備:
- Google Cloud Console で OAuth 2.0 クライアント ID (「デスクトップアプリ」または「ウェブ アプリケーション」タイプ) を作成します。その際、Google Tasks API と Google Calendar API を有効にしてください。
- 作成した認証情報を JSON 形式でダウンロードし、ファイル名を credentials.json として、このプロジェクトのルートディレクトリ (ai-scheduler-mcp/) に保存します。
- 重要: credentials.json は機密情報です。絶対に Git リポジトリにコミットしないでください。 (.gitignore に含まれています)
3. Docker イメージのビルド:
プロジェクトの管理には scripts/ai-scheduler-mcp.sh スクリプトを使用します。コマンドを簡略化するために、便利な使い方 (エイリアス) セクションを参照してエイリアス (ai_scheduler_mcp など) を設定することを推奨します。
以下のコマンドで Docker イメージをビルドします (エイリアス設定後):
ai_scheduler_mcp build
初回認証 (token.json の生成)
サーバーを初めて使用する前に、Google アカウントでの認証を行い、API アクセスに必要な token.json を生成する必要があります。
1. 以下のコマンドを実行します:
ai_scheduler_mcp start-auth
(ポートを変更する場合は -P <ポート番号> オプションを追加します)
2. コンソールに認証 URL が表示されるので、Web ブラウザでアクセスし、Google アカウントでログインして要求された権限を承認します。
3. 承認後に表示される認証コードをコピーし、コンソールの指示に従って貼り付け、Enter キーを押します。
4. 認証が成功すると、プロジェクトルートに token.json が生成されます。
- 重要: token.json も機密情報です。絶対に Git リポジトリにコミットしないでください。 (.gitignore に含まれています)
通常起動
初回認証が完了し token.json が生成された後は、以下のコマンドでサーバーを起動できます。
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
