Vikunja MCP Server
vikunja-mcp
Claudeをセルフホスト型のVikunjaインスタンスに接続するためのリモートMCP(Model Context Protocol)サーバーです。Claude.aiのカスタムコネクタとして追加することで、会話形式でタスクを管理できます。
利用可能なツール
ツール | 説明 |
| すべてのプロジェクトを一覧表示 |
| プロジェクトの詳細を取得 |
| 新しいプロジェクトを作成 |
| プロジェクトを更新 |
| プロジェクトを削除 |
| すべてのプロジェクトのタスクを一覧/フィルタ/検索 |
| コメントを含むタスクの詳細を取得 |
| プロジェクト内にタスクを作成 |
| タスクのプロパティを更新 |
| タスクを削除 |
| タスクを完了にする |
| タスクを未完了に戻す |
| タスクにコメントを追加 |
| すべてのラベルを一覧表示 |
| 新しいラベルを作成 |
| タスクにラベルを付与 |
| タスクからラベルを削除 |
| 週間レビューの要約を生成 |
| 期日(期限切れ+今後)のあるタスクのアジェンダ表示 |
| 2つのタスクをリンク(サブタスク、ブロック、先行、関連など) |
| 2つのタスク間の関連付けを削除 |
Related MCP server: vikunja-mcp
クイックスタート
npm install
npm run build
export VIKUNJA_URL=https://your-vikunja-instance.example.com
export VIKUNJA_TOKEN=your-api-token
export MCP_AUTH_TOKEN=$(openssl rand -hex 32)
export PORT=9090
node build/index.js次に、Claude.aiの「設定」>「コネクタ」から、サーバーをカスタムコネクタとして追加します:
https://your-server.example.com/mcp?token=<MCP_AUTH_TOKEN>Uberspaceでの完全なデプロイ手順については、DEPLOY-UBERSPACE.mdを参照してください。
設定
変数 | 必須 | 説明 |
| はい | VikunjaインスタンスのベースURL(末尾のスラッシュは不要) |
| はい | Vikunjaの「設定」>「APIトークン」から取得したAPIトークン |
| 推奨 |
|
| いいえ | リッスンするポート(デフォルト: |
認証
MCP_AUTH_TOKENが設定されている場合、サーバーは一致する?token=…クエリパラメータを含まない/mcpへのリクエストを拒否し、401 Unauthorizedを返します。
強力なトークンを生成します:
openssl rand -hex 32Claude.aiのコネクタURLに追加します:
https://your-server.example.com/mcp?token=<your-token>MCP_AUTH_TOKENが設定されていない場合、エンドポイントはアクセス可能な誰に対しても開かれます。これはプライベートなファイアウォールで保護されたネットワーク内でのみ行ってください。
カレンダーフィード
サーバーは、任意のカレンダーアプリで購読可能な機械可読なiCalフィードを公開します:
webcal://your-server.example.com/calendar.icsこれには、開始日、期日、または終了日があるすべての未完了タスクと、過去30日以内に完了したタスクが含まれます。一度購読すれば、カレンダーアプリが自動的にポーリングを行います。
アーキテクチャ
トランスポート: ストリーミング可能なHTTP(ステートレス) — リモートサーバー向けの現在のMCP標準
認証: MCPエンドポイント用のクエリパラメータトークン(
MCP_AUTH_TOKEN)、アップストリームAPI呼び出し用のVikunja APIトークンランタイム: Node.js + Express
SDK:
@modelcontextprotocol/sdkv1.x
要件
Node.js ≥ 18
APIトークンを持つセルフホスト型のVikunjaインスタンス
Claude.aiがサーバーに到達するための公開アクセス可能なURL
This server cannot be deployed
Maintenance
Related MCP Connectors
Persistent context for Claude. Your AI always knows your projects and next actions across sessions.
- platform7nOAuthtech.p7n
Connect Claude to your Platform7n workspaces — chat, links, and tasks. One-click OAuth.
Notes and actions in one app. Let Claude or ChatGPT read and update them.
Personal CRM for Claude. Contacts live as plain-text files in your own Google Drive.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables interaction with Vikunja task management instances through natural language. Supports comprehensive project and task operations including CRUD, assignments, labels, comments, relations, and attachments.3344 npm2MIT
- AlicenseCqualityCmaintenanceEnables AI assistants to interact with Vikunja task management via ergonomic and raw REST tools for projects, tasks, labels, and comments.10010 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables to interact with Vikunja task management through its REST API, supporting projects, tasks, comments, labels, assignees, and relations with field preservation.44 npmMIT
- AlicenseCqualityDmaintenanceEnables AI assistants to interact with Vikunja task management instances, providing full task, project, label, and user management capabilities.17141 npmMIT