Skip to content

garoon/garoon-mcp-server

BranchesTags

Repository files navigation

Garoon MCP Server

ci License

日本語 | English

Garoonの公式ローカルMCPサーバーです。

インストール

MCPB (旧称: DXT)

MCPBは、2025年10月時点では、Claude for desktopのみがサポートしているインストール方式です。
.mcpbファイルをClaudeで開くだけでインストールすることができます。

  1. リリース一覧を開く。
  2. Assetsにあるgaroon-mcp-server.mcpbをダウンロードする。
  3. ダウンロードしたファイルをClaudeで開く。
  4. インストール確認ダイアログが表示されるのでインストールを選択する。
  5. 設定ダイアログが表示されるので、必要な情報を入力して保存する。
  6. トグルスイッチでGaroon MCP Serverが無効になっていれば有効にする。

Dockerイメージ

Dockerをインストールして使える状態にする必要があります。 インストール後、以下のコマンドでDockerイメージをプルできます。

docker pull ghcr.io/garoon/mcp-server:latest

この方法で利用するにはMCPクライアントに応じた設定ファイルが必要です。 後述の設定ファイルの例をご参考ください。

npmパッケージ

Node.jsをインストールして使える状態にする必要があります。 インストール後、以下のコマンドでグローバルインストールできます。

npm install -g @garoon/mcp-server

この方法で利用するにはMCPクライアントに応じた設定ファイルが必要です。 後述の設定ファイルの例をご参考ください。

設定ファイルの例

Warning

ログイン情報を含む設定ファイルをコンピュータ上に保存することはセキュリティ上のリスクがあります。適切に管理していただき、ご利用は自己責任でお願いいたします。

ファイルパス

詳細や最新情報については、利用したいMCPクライアントツールの公式ドキュメントをご参照ください。

Cursorの例[ref]:

特定のワークスペース内で以下のファイルを作成します。

  • .cursor/mcp.json

Visual Studio Codeの例[ref]:

特定のワークスペース内で以下のファイルを作成します。

  • .vscode/mcp.json

設定内容

設定は環境変数で行います。 不要な環境変数については省略できるため、ご利用の環境に合わせて削除してください。 環境変数の意味については後述の設定項目をご参照ください。

Cursor

Dockerイメージの場合 
{
  "mcpServers": {
    "garoon-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "GAROON_BASE_URL",
        "-e",
        "GAROON_USERNAME",
        "-e",
        "GAROON_PASSWORD",
        "-e",
        "https_proxy",
        "-e",
        "GAROON_BASIC_AUTH_USERNAME",
        "-e",
        "GAROON_BASIC_AUTH_PASSWORD",
        "ghcr.io/garoon/mcp-server:latest"
      ],
      "env": {
        "GAROON_BASE_URL": "https://example.cybozu.com/g",
        "GAROON_USERNAME": "username",
        "GAROON_PASSWORD": "password",
        "https_proxy": "http://proxy.example.com:8080",
        "GAROON_BASIC_AUTH_USERNAME": "username",
        "GAROON_BASIC_AUTH_PASSWORD": "password"
      }
    }
  }
}

クライアント証明書を利用する場合は、docker runの--mountオプション[ref]でホストマシン上の*.pfxファイルをコンテナ内にマウントする必要があります。

{
  "mcpServers": {
    "garoon-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--mount",
        "type=bind,src=/absolute/path/to/pfx_file.pfx,dst=/cert.pfx",
        "-e",
        "GAROON_BASE_URL",
        "-e",
        "GAROON_USERNAME",
        "-e",
        "GAROON_PASSWORD",
        "-e",
        "GAROON_PFX_FILE_PATH",
        "-e",
        "GAROON_PFX_FILE_PASSWORD",
        "ghcr.io/garoon/mcp-server:latest"
      ],
      "env": {
        "GAROON_BASE_URL": "https://example.s.cybozu.com/g",
        "GAROON_USERNAME": "username",
        "GAROON_PASSWORD": "password",
        "GAROON_PFX_FILE_PATH": "/cert.pfx",
        "GAROON_PFX_FILE_PASSWORD": "password"
      }
    }
  }
}
npmパッケージの場合 
{
  "mcpServers": {
    "garoon-mcp-server": {
      "command": "garoon-mcp-server",
      "env": {
        "GAROON_BASE_URL": "https://example.s.cybozu.com/g",
        "GAROON_USERNAME": "username",
        "GAROON_PASSWORD": "password",
        "https_proxy": "http://proxy.example.com:8080",
        "GAROON_PFX_FILE_PATH": "/absolute/path/to/pfx_file.pfx",
        "GAROON_PFX_FILE_PASSWORD": "pfx_password",
        "GAROON_BASIC_AUTH_USERNAME": "username",
        "GAROON_BASIC_AUTH_PASSWORD": "password"
      }
    }
  }
}

お使いの環境によっては、グローバルインストールしたgaroon-mcp-serverコマンドのPATHが正しく解決されない場合があります。 コマンドを絶対パスで指定するか、npxコマンドをお試しください。

{
  "mcpServers": {
    "garoon-mcp-server": {
      "command": "npx",
      "args": ["@garoon/mcp-server"],
      "env": {
        "GAROON_BASE_URL": "https://example.cybozu.com/g",
        "GAROON_USERNAME": "username",
        "GAROON_PASSWORD": "password"
      }
    }
  }
}

Visual Studio Code

Dockerイメージの場合 
{
  "servers": {
    "garoon-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "GAROON_BASE_URL",
        "-e",
        "GAROON_USERNAME",
        "-e",
        "GAROON_PASSWORD",
        "-e",
        "https_proxy",
        "-e",
        "GAROON_BASIC_AUTH_USERNAME",
        "-e",
        "GAROON_BASIC_AUTH_PASSWORD",
        "ghcr.io/garoon/mcp-server:latest"
      ],
      "env": {
        "GAROON_BASE_URL": "https://example.cybozu.com/g",
        "GAROON_USERNAME": "username",
        "GAROON_PASSWORD": "password",
        "https_proxy": "http://proxy.example.com:8080",
        "GAROON_BASIC_AUTH_USERNAME": "username",
        "GAROON_BASIC_AUTH_PASSWORD": "password"
      }
    }
  }
}

クライアント証明書を利用する場合は、docker runの--mountオプション[ref]でホストマシン上の*.pfxファイルをコンテナ内にマウントする必要があります。

{
  "servers": {
    "garoon-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--mount",
        "type=bind,src=/absolute/path/to/pfx_file.pfx,dst=/cert.pfx",
        "-e",
        "GAROON_BASE_URL",
        "-e",
        "GAROON_USERNAME",
        "-e",
        "GAROON_PASSWORD",
        "-e",
        "GAROON_PFX_FILE_PATH",
        "-e",
        "GAROON_PFX_FILE_PASSWORD",
        "ghcr.io/garoon/mcp-server:latest"
      ],
      "env": {
        "GAROON_BASE_URL": "https://example.s.cybozu.com/g",
        "GAROON_USERNAME": "username",
        "GAROON_PASSWORD": "password",
        "GAROON_PFX_FILE_PATH": "/cert.pfx",
        "GAROON_PFX_FILE_PASSWORD": "password"
      }
    }
  }
}
npmパッケージの場合 
{
  "servers": {
    "garoon-mcp-server": {
      "type": "stdio",
      "command": "garoon-mcp-server",
      "env": {
        "GAROON_BASE_URL": "https://example.s.cybozu.com/g",
        "GAROON_USERNAME": "username",
        "GAROON_PASSWORD": "password",
        "https_proxy": "http://proxy.example.com:8080",
        "GAROON_PFX_FILE_PATH": "/absolute/path/to/pfx_file.pfx",
        "GAROON_PFX_FILE_PASSWORD": "pfx_password",
        "GAROON_BASIC_AUTH_USERNAME": "username",
        "GAROON_BASIC_AUTH_PASSWORD": "password"
      }
    }
  }
}

お使いの環境によっては、グローバルインストールしたgaroon-mcp-serverコマンドのPATHが正しく解決されない場合があります。 コマンドを絶対パスで指定するか、npxコマンドをお試しください。

{
  "servers": {
    "garoon-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["@garoon/mcp-server"],
      "env": {
        "GAROON_BASE_URL": "https://example.cybozu.com/g",
        "GAROON_USERNAME": "username",
        "GAROON_PASSWORD": "password"
      }
    }
  }
}

設定項目

MCPB Docker/npmの環境変数 説明 必須
Garoon Base URL GAROON_BASE_URL Garoon環境のベースURL
例1: https://example.cybozu.com/g
例2: https://example.com/cgi-bin/cbgrn/grn.cgi		 ✓
Garoon Username GAROON_USERNAME Garoonのログイン名 ✓
Garoon Password GAROON_PASSWORD Garoonのログインパスワード ✓
HTTPS Proxy https_proxy HTTPSプロキシのURL
例: http://proxy.example.com:8080		 -
PFX File Path GAROON_PFX_FILE_PATH クライアント証明書（*.pfx）の絶対パス -
PFX File Password GAROON_PFX_FILE_PASSWORD クライアント証明書のパスワード -
Basic Auth Username GAROON_BASIC_AUTH_USERNAME Basic認証のユーザー名 -
Basic Auth Password GAROON_BASIC_AUTH_PASSWORD Basic認証のパスワード -

注意事項:

  • クライアント証明書認証を使用する場合、URLのドメインは .s.cybozu.com となります（例: https://example.s.cybozu.com）

ツール一覧

ツール名 説明
Create Schedule Event スケジュールを作成します。
Get Schedule Events ユーザー/組織/施設を指定し、対象の予定を取得します。
Search Available Times ユーザーや時間範囲などの条件を指定して空き時間を検索します。
Get Facilities 施設名から施設IDを検索します。
Get Current Datetime 現在の日時を取得します。
Get Garoon Users 名前からユーザーID/表示名/ログイン名を検索します。
「私」「自分」等のプロンプトにも対応しています。
Get Organizations 組織名から組織IDを検索します。
Get Users In Organization 指定した組織IDに所属するユーザーを取得します。

注意事項:

  • ツールは内部的にGaroonのREST APIを使用しています。 パッケージ版をご利用の場合、バージョンによってはツールが使用するREST APIがGaroon側に存在しない場合がございます。
    REST APIの対応バージョンについてはGaroon APIドキュメントをご参照ください。

サポート方針

GaroonローカルMCPサーバーは、サポート窓口の対象外です。
バグ報告や機能要望はIssuesから登録をお願いします。

コントリビューション

Contributing Guide を参照してください。

ライセンス

Copyright 2025 Cybozu, Inc.

Licensed under the Apache 2.0.

About

Garoon official MCP server

Resources

Readme

License

Apache-2.0 license

Contributing

Contributing
Activity
Custom properties

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases 5

v1.0.1 Latest
Oct 22, 2025
+ 4 releases

Packages

 
 
 

Contributors 15

Languages