garoon-mcp-server
This server lets you manage Garoon schedules, check availability, look up facilities/users/organizations, and browse bulletin boards via MCP tools.
Create new schedule events.
Retrieve schedule events for a user, organization, or facility within a date range.
Retrieve comments on a schedule event.
Search for available time slots for attendees and/or facilities.
Look up facilities by name, list facility groups, and list facilities within a group.
Get the current datetime in a specified timezone.
Search Garoon users, organizations, and users belonging to an organization.
Browse bulletin board categories, list topics within a category, and get detailed information for a specific topic.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@garoon-mcp-server Get my schedule for tomorrow"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Garoon MCP Server
日本語 | English
Garoonの公式ローカルMCPサーバーです。
インストール
MCPB (旧称: DXT)
MCPBは、Claude for desktopのみがサポートしているインストール方式です。.mcpbファイルをClaudeで開くだけでインストールすることができます。
リリース一覧を開く。
Assetsにある
garoon-mcp-server.mcpbをダウンロードする。ダウンロードしたファイルをClaudeで開く。
インストール確認ダイアログが表示されるのでインストールを選択する。
設定ダイアログが表示されるので、必要な情報を入力して保存する。
トグルスイッチで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
設定ファイルの例
ログイン情報を含む設定ファイルをコンピュータ上に保存することはセキュリティ上のリスクがあります。適切に管理していただき、ご利用は自己責任でお願いいたします。
ファイルパス
詳細や最新情報については、利用したい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環境のベースURL例1: | ✓ |
|
| Garoonのログイン名 | ✓ |
|
| Garoonのログインパスワード | ✓ |
|
| HTTPSプロキシのURL例: | - |
|
| クライアント証明書( | - |
|
| クライアント証明書のパスワード | - |
|
| Basic認証のユーザー名 | - |
|
| Basic認証のパスワード | - |
|
| 非公開予定を除外するモード(デフォルト: 無効)有効にすると予定取得ツールはレスポンスから非公開予定を除外します。また、コメント取得ツールは非公開予定のコメントを返さず、エラーを返します。MCPBではチェックボックスをオンにし、Docker/npmでは環境変数に | - |
注意事項:
クライアント証明書認証を使用する場合、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 toolsgaroon-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 CategoriesARead-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 DetailARead-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 TopicsARead-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 DatetimeARead-only
Get the current datetime in RFC 3339 format in Garoon.
Inputs: timezone. Returns: error, result, status, responseText
garoon-get-facilitiesGet FacilitiesARead-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 GroupARead-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 GroupsBRead-only
Get facility groups data from Garoon with optional limit and offset parameters.
Inputs: limit, offset. Returns: error, result, status, responseText
garoon-get-organizationsGet OrganizationsARead-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 CommentsARead-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 EventsCRead-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 UsersARead-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 OrganizationARead-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 TimesCRead-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
Scored across 14 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
AI から使えるクラウドグループウェア Work Handler の MCP サーバー。組織・メンバーの参照、出退勤の共有、タイムカード、承認フロー等を本人の権限の範囲で操作できる。
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Related MCP Servers
- AlicenseAqualityDmaintenanceA 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.101MIT

kintone MCP Serverofficial
AlicenseBqualityAmaintenanceOfficial MCP server for kintone, enabling AI assistants to manage kintone apps, records, and settings through natural language.201,222 npm59Apache 2.0- AlicenseNot gradedqualityDmaintenanceOfficial MCP server for Feishu/Lark OpenAPI, enabling AI assistants to interact with Feishu/Lark platform for document processing, messaging, calendar scheduling, and more.33,351 npmMIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that integrates Cybozu's Garoon groupware, enabling schedule management, meeting scheduling, and user search through natural language.MIT