Skip to main content
Glama
deenesjakoruzh

mcp-nextcloud-calendar

by Cheffromspace
npmGitHub
TypeScript
ISC License
35
2
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCP Nextcloud カレンダー

Nextcloud カレンダー統合用のモデル コンテキスト プロトコル (MCP) サーバー。

特徴

  • Nextcloudからカレンダーを取得する
  • ADHDに優しい整理機能
  • MCP プロトコルのサポート (ストリーミング可能な HTTP およびレガシー HTTP+SSE)

使用法

npx での使用

このパッケージを使用する最も簡単な方法は npx を使用することです。

npx mcp-nextcloud-calendar

インストール

開発またはローカルインストールの場合:

# Install globally npm install -g mcp-nextcloud-calendar # Or install locally npm install mcp-nextcloud-calendar

MCP クライアント構成

MCP クライアント (Claude など) で使用するには、次の構成を MCP クライアント設定に追加します。

{ "mcpServers": { "nextcloud-calendar": { "command": "npx", "args": ["-y", "mcp-nextcloud-calendar"], "env": { "NEXTCLOUD_BASE_URL": "https://your-nextcloud-server.com", "NEXTCLOUD_USERNAME": "your-username", "NEXTCLOUD_APP_TOKEN": "your-app-token" } } } }
バージョンの指定

パッケージの特定のバージョンに固定することができます。

{ "mcpServers": { "nextcloud-calendar": { "command": "npx", "args": ["-y", "mcp-nextcloud-calendar@0.1.0"], "env": { "NEXTCLOUD_BASE_URL": "https://your-nextcloud-server.com", "NEXTCLOUD_USERNAME": "your-username", "NEXTCLOUD_APP_TOKEN": "your-app-token" } } } }

構成

環境変数

サーバーは、可能な場合はデフォルトを使用して、次の環境変数を使用します。

変数説明デフォルト必須
ポートサーバーポート3001いいえ
サーバー名MCP サーバー識別子nextcloud カレンダーサーバーいいえ
ノード環境環境（開発・生産）発達いいえ
NEXTCLOUD_BASE_URLNextcloudサーバーのURL-はい
NEXTCLOUD_ユーザー名Nextcloudのユーザー名-はい
NEXTCLOUD_APP_TOKENNextcloudアプリトークン-はい
キープアライブ間隔キープアライブ間隔（ミリ秒）30000いいえ

開発セットアップ

地域開発の場合:

  1. リポジトリをクローンする
  2. 依存関係をインストールします:
npm install
  1. プロジェクト ルートに.envファイルを作成します。
cp .env.example .env
  1. Nextcloud の資格情報を使用して.envファイルを編集します。

Nextcloudアプリトークンの取得

  1. Nextcloudインスタンスにログインする
  2. 「設定」→「セキュリティ」→「アプリパスワード」へ移動します。
  3. 「MCPカレンダー」のような名前で新しいアプリパスワードを作成します
  4. 生成されたトークンを.envファイルにコピーします。

発達

# Build the project npm run build # Run in development mode npm run dev # Run tests npm run test # Run linting npm run lint # Format code npm run format

APIエンドポイント

  • /mcp - プライマリ MCP エンドポイント (ストリーミング可能な HTTP トランスポート)
  • /sseおよび/messages - レガシー MCP エンドポイント (HTTP+SSE トランスポート)
  • GET /health - ヘルスチェックエンドポイント
  • GET /api/calendars - すべてのカレンダーを一覧表示する

MCPツール

次の MCP ツールが登録されており、クライアントが利用できます。

カレンダー管理

道具説明パラメータ
listCalendarsアクセス可能なすべてのカレンダーを取得しますなし
createCalendar新しいカレンダーを作成しますdisplayName （必須）、 color （オプション）、 category （オプション）、 focusPriority （オプション）
updateCalendar既存のカレンダーを更新しますid （必須）、 displayName （オプション）、 color （オプション）、 category （オプション）、 focusPriority （オプション）
deleteCalendarカレンダーを削除しますid （必須）

⚠️ 権限に関する警告： updateCalendarおよびdeleteCalendarツールは、Nextcloudインスタンスで特別な権限を必要とする場合があります。カレンダーの操作はNextcloudの権限システムに従います。

イベント管理

道具説明パラメータ
listEventsカレンダーのイベントを取得しますcalendarId （必須）、 start （オプション）、 end （オプション）
getEvent特定のイベントを取得するcalendarId （必須）、 eventId （必須）
createEvent新しいイベントを作成しますcalendarId （必須）、 summary （必須）、 start （必須）、 end （必須）、 description （オプション）、 location （オプション）
updateEvent既存のイベントを更新しますcalendarId （必須）、 eventId （必須）、[および更新するイベントのプロパティ]
deleteEventイベントを削除しますcalendarId （必須）、 eventId （必須）

既知の問題と制限事項

注意：このパッケージは現在開発初期段階（0.1.x）です。APIとツールは将来のリリースで予告なく変更される可能性があります。

  • カレンダーの更新と削除の操作には、Nextcloudインスタンスでの特定の権限が必要になる場合があります。
  • 特定のNextcloudエラーコードに対するエラー処理はまだ改善中です
  • 多くのイベントを含む大きなカレンダーではパフォーマンスの問題が発生する可能性があります

問題が発生した場合は、GitHub リポジトリに報告してください。

ライセンス

ISC

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

mcp-nextcloud-カレンダー

  1. 特徴
    1. 使用法
      1. npx での使用
      2. インストール
      3. MCP クライアント構成
    2. 構成
      1. 環境変数
      2. 開発セットアップ
      3. Nextcloudアプリトークンの取得
    3. 発達
      1. APIエンドポイント
        1. MCPツール
          1. カレンダー管理
          2. イベント管理
        2. 既知の問題と制限事項
          1. ライセンス

            Related MCP Servers

            • Google Workspace MCP Server

              epaproditus
              A
              security
              A
              license
              A
              quality
              Provides tools for interacting with Gmail and Calendar APIs. This server enables you to manage your emails and calendar events programmatically through the MCP interface.
              Last updated -
              8
              13
              JavaScript
              MIT License

            • Cal.com Calendar MCP Server

              mumunha
              -
              security
              F
              license
              -
              quality
              An MCP server that enables scheduling, updating, deleting, and listing calendar appointments through Cal.com's Calendar API.
              Last updated -
              JavaScript

            • GoogleCalendarMCP

              ITworkonline
              -
              security
              F
              license
              -
              quality
              A Model Completion Prompt (MCP) plugin that allows users to create events in Google Calendar with customizable attributes like times, description, location, attendees, and timezone.
              Last updated -
              Python
              • Linux
              • Apple

            View all related MCP servers

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/Cheffromspace/mcp-nextcloud-calendar'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server