Skip to main content
Glama
garoon-mcp-server
by garoon

Garoon MCP Server

ci License

日本語 | English

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

インストール

MCPB (旧称: DXT)

MCPBは、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クライアントに応じた設定ファイルが必要です。 後述の設定ファイルの例をご参考ください。

Related MCP server: kintone MCP Server

設定ファイルの例

WARNING

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

ファイルパス

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

Cursorの例[ref]:

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

  • .cursor/mcp.json

Visual Studio Codeの例[ref]:

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

  • .vscode/mcp.json

設定内容

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

Cursor

{
  "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",
        "-e",
        "GAROON_PUBLIC_ONLY",
        "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",
        "GAROON_PUBLIC_ONLY": "false"
      }
    }
  }
}

クライアント証明書を利用する場合は、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",
        "-e",
        "GAROON_PUBLIC_ONLY",
        "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",
        "GAROON_PUBLIC_ONLY": "false"
      }
    }
  }
}
{
  "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_PUBLIC_ONLY": "false"
      }
    }
  }
}

お使いの環境によっては、グローバルインストールした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",
        "GAROON_PUBLIC_ONLY": "false"
      }
    }
  }
}

Visual Studio Code

{
  "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",
        "-e",
        "GAROON_PUBLIC_ONLY",
        "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",
        "GAROON_PUBLIC_ONLY": "false"
      }
    }
  }
}

クライアント証明書を利用する場合は、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",
        "-e",
        "GAROON_PUBLIC_ONLY",
        "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",
        "GAROON_PUBLIC_ONLY": "false"
      }
    }
  }
}
{
  "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_PUBLIC_ONLY": "false"
      }
    }
  }
}

お使いの環境によっては、グローバルインストールした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",
        "GAROON_PUBLIC_ONLY": "false"
      }
    }
  }
}

設定項目

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認証のパスワード

-

Public Only Mode

GAROON_PUBLIC_ONLY

非公開予定を除外するモード(デフォルト: 無効)有効にすると予定取得ツールはレスポンスから非公開予定を除外します。また、コメント取得ツールは非公開予定のコメントを返さず、エラーを返します。MCPBではチェックボックスをオンにし、Docker/npmでは環境変数にtrueを設定します。

-

注意事項:

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

ツール一覧

ツール名

説明

Create Schedule Event

スケジュールを作成します。

Get Schedule Events

ユーザー/組織/施設を指定し、対象の予定を取得します。

Get Schedule Event Comments

指定した予定のコメント一覧を取得します。

Search Available Times

ユーザーや時間範囲などの条件を指定して空き時間を検索します。

Get Facilities

施設名から施設IDを検索します。

Garoon Get Facility Groups

施設グループの一覧を取得します。

Get Facilities In Group

指定した施設グループに所属する施設を取得します。

Get Current Datetime

現在の日時を取得します。

Get Garoon Users

名前からユーザーID/表示名/ログイン名を検索します。「私」「自分」等のプロンプトにも対応しています。

Get Organizations

組織名から組織IDを検索します。

Get Users In Organization

指定した組織IDに所属するユーザーを取得します。

Garoon Get Bulletin Categories

掲示板のカテゴリー一覧を取得します。

Garoon Get Bulletin Topics

指定したカテゴリーに含まれる掲示の一覧を取得します。

Garoon Get Bulletin Topic Detail

指定した掲示の本文、添付ファイル、公開期間などの詳細を取得します。

注意事項:

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

  • 本MCPサーバーはDB分割構成には対応していません。

サポート方針

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

コントリビューション

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

ライセンス

Copyright 2025 Cybozu, Inc.

Licensed under the Apache 2.0.

Available Tools

14 tools
garoon-create-schedule-eventCreate Schedule EventC

Create a new schedule event in Garoon

Inputs: start (required), end, notes, subject, +9 more. Returns: error, result, status, responseText

garoon-get-bulletin-categoriesGaroon Get Bulletin CategoriesA
Read-only

Get bulletin board categories from Garoon. Use parentId to browse sub-categories. Special values: 1=root (default), -1=pending approval, -2=drafts.

Inputs: limit, offset, parentId. Returns: error, result, status, responseText

garoon-get-bulletin-topicGaroon Get Bulletin Topic DetailA
Read-only

Get full details of a specific bulletin board topic from Garoon, including body content, attachments, public period, and metadata.

Inputs: topicId (required). Returns: error, result, status, responseText

garoon-get-bulletin-topicsGaroon Get Bulletin TopicsA
Read-only

Get bulletin board topics in a specific category from Garoon. Returns topic summaries with subject, updater, and update time.

Inputs: categoryId (required), limit, offset. Returns: error, result, status, responseText

garoon-get-current-timeGet Current DatetimeA
Read-only

Get the current datetime in RFC 3339 format in Garoon.

Inputs: timezone. Returns: error, result, status, responseText

garoon-get-facilitiesGet FacilitiesA
Read-only

Get facilities data from Garoon by searching facility names with optional limit and offset parameters.

Inputs: name (required), limit, offset. Returns: error, result, status, responseText

garoon-get-facilities-in-groupGet Facilities In GroupA
Read-only

Get facilities that belong to a specific facility group with optional limit and offset parameters.

Inputs: facilityGroupId (required), limit, offset. Returns: error, result, status, responseText

garoon-get-facility-groupsGaroon Get Facility GroupsB
Read-only

Get facility groups data from Garoon with optional limit and offset parameters.

Inputs: limit, offset. Returns: error, result, status, responseText

garoon-get-organizationsGet OrganizationsA
Read-only

Get Garoon organization's name, ID, and code data by searching for organization names - supports pagination with optional limit and offset parameters.

Inputs: name (required), limit, offset. Returns: error, result, status, responseText

garoon-get-schedule-event-commentsGet Schedule Event CommentsA
Read-only

Get the list of comments on a Garoon schedule event, including each comment's author, creation datetime, body, and mentions. Supports optional limit and offset parameters for pagination. NOTE: If GAROON_PUBLIC_ONLY is set to 'true', comments of private events are not returned and this tool fails with an error.

Inputs: eventId (required), limit, offset. Returns: error, result, status, responseText

garoon-get-schedule-eventsGet Schedule EventsC
Read-only

Search for schedule events in a specified period in Garoon

Inputs: target (required), rangeEnd (required), rangeStart (required), limit, +3 more. Returns: error, result, status, responseText

garoon-get-usersGet Garoon UsersA
Read-only

Get user data (name, ID, code) from Garoon by searching name/code. IMPORTANT: Omit name parameter for self-referential queries ('me', 'my', 'I', 'myself', 私, 僕, 自分) to return current user info. Supports pagination.

Inputs: name, limit, offset. Returns: error, result, status, responseText

garoon-get-users-in-organizationGet Users In OrganizationA
Read-only

Get users from a specific organization with support for pagination parameters (limit, offset) in Garoon.

Inputs: organizationId (required), limit, offset. Returns: error, result, status, responseText

garoon-search-available-timesSearch Available TimesC
Read-only

Search for available time slots for specified attendee or facility within given time ranges in Garoon

Inputs: timeRanges (required), timeInterval (required), attendees, facilities, +1 more. Returns: error, result, status, responseText

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 14 tools

    Disambiguation4/5

    Most tools target clearly distinct resources and actions (create schedule event, search available times, get comments, get facilities vs facility groups vs facilities-in-group, bulletin categories vs topics vs topic). The only mild overlap is get-users vs get-users-in-organization, but descriptions make the boundary clear.

    Naming Consistency5/5

    Every tool uses the same garoon- prefix followed by a kebab-case verb_noun pattern (create-schedule-event, get-facilities, get-bulletin-topics). Naming is highly predictable and uniform across all 14 tools.

    Tool Count5/5

    14 tools is well within a healthy range for a groupware server covering scheduling, facilities, organizations, and bulletins. Each tool maps to a distinct resource or query, with no filler.

    Completeness3/5

    Coverage is heavily read-oriented: schedules support create+get but no update/delete, and bulletins are read-only (categories/topics/topic) with no create or reply. Core browsing is thorough, but write/lifecycle operations for bulletins and event management leave notable gaps.

    Maintenance

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A lightweight MCP server that connects AI assistants to Kintone applications for managing records and automating business workflows. It enables secure authentication and natural language interaction for performing CRUD operations and querying data within the Kintone platform.
      10
      1
      MIT
    • A
      license
      B
      quality
      A
      maintenance
      Official MCP server for kintone, enabling AI assistants to manage kintone apps, records, and settings through natural language.
      20
      1,222 npm
      59
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that integrates Cybozu's Garoon groupware, enabling schedule management, meeting scheduling, and user search through natural language.
      MIT