jpskill.com
🛠️ 開発・MCP コミュニティ

tasknotes

Manage tasks in Obsidian via TaskNotes plugin API. Use when user wants to create tasks, list tasks, query by status or project, update task status, delete tasks, or check what they need to do.

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o tasknotes.zip https://jpskill.com/download/17278.zip && unzip -o tasknotes.zip && rm tasknotes.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/17278.zip -OutFile "$d\tasknotes.zip"; Expand-Archive "$d\tasknotes.zip" -DestinationPath $d -Force; ri "$d\tasknotes.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して tasknotes.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → tasknotes フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
2

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

TaskNotes Skill

TaskNotes プラグインの HTTP API を介して Obsidian のタスクを管理します。

要件

  1. Obsidian に TaskNotes plugin がインストールされていること
  2. TaskNotes の設定で HTTP API を有効にすること:
    • Obsidian の設定 → TaskNotes を開きます
    • "HTTP API" トグルを有効にします
    • API ポートを設定します (デフォルト: 8080)
    • API トークン: 認証なしの場合は空のままにするか、セキュリティのためにトークンを設定します
  3. (認証を使用する場合) vault のルートにある .env ファイルに 環境変数 を設定します:
    TASKNOTES_API_PORT=8080
TASKNOTES_API_KEY=your_token_here

    TaskNotes に認証トークンが設定されていない場合は、.env ファイルは不要です。

CLI コマンド

# すべてのタスクをリスト表示
uv run scripts/tasks.py list

# ステータスでリスト表示 (設定したステータス値を使用)
uv run scripts/tasks.py list --status "in-progress"

# プロジェクトでリスト表示
uv run scripts/tasks.py list --project "My Project"

# タスクを作成
uv run scripts/tasks.py create "Task title" --project "My Project" --priority high

# 予定時刻付きのタスクを作成
uv run scripts/tasks.py create "Meeting prep" --scheduled "2025-01-15T14:00:00"

# タスクのステータスを更新
uv run scripts/tasks.py update "Tasks/task-file.md" --status done

# タスクの説明を追加/更新
uv run scripts/tasks.py update "Tasks/task-file.md" --details "Additional context here."

# タスクを削除
uv run scripts/tasks.py delete "Tasks/task-file.md"

# 利用可能なオプションを取得 (ステータス、優先度、プロジェクト)
uv run scripts/tasks.py options --table

# 人間が読める形式で出力 (--table を追加)
uv run scripts/tasks.py list --table

タスクのプロパティ

Status と Priority の値: TaskNotes プラグインの設定で設定します。利用可能な値を確認するには、options コマンドを実行します:

uv run scripts/tasks.py options --table

その他のフィールド:

  • projects - プロジェクトリンクの配列。例: ["[[Project Name]]"]
  • contexts - ["office", "energy-high"] のような配列
  • due - 期日 (YYYY-MM-DD)
  • scheduled - 予定日時 (YYYY-MM-DD または YYYY-MM-DDTHH:MM:SS)
  • timeEstimate - 見積もり時間 (分単位の数値)
  • tags - タグの配列
  • details - タスクの説明 (フロントマターではなく、markdown 本文に書き込まれます)

API リファレンス

ベース URL: http://localhost:8080/api

メソッド エンドポイント 説明
GET /tasks タスクをリスト表示 (フィルターをサポート)
POST /tasks タスクを作成
GET /tasks/{id} 単一のタスクを取得
PUT /tasks/{id} タスクを更新
DELETE /tasks/{id} タスクを削除
GET /filter-options 利用可能なステータス、優先度、プロジェクト

GET /tasks のクエリパラメータ

  • status - ステータスでフィルタリング
  • project - プロジェクト名でフィルタリング
  • priority - 優先度でフィルタリング
  • tag - タグでフィルタリング
  • overdue - true/false
  • sort - ソートフィールド
  • limit - 最大結果数
  • offset - ページネーションオフセット

どのような時に使うか

  • "X のタスクを作成" → タスクを作成
  • "私のタスクを表示" → すべてのタスクをリスト表示
  • "進行中のタスクを表示" → list --status in-progress
  • "X を完了としてマーク" → タスクのステータスを done に更新
  • "何に取り組むべきか" → ステータスでタスクをリスト表示

ワークフローの例

# 朝: 何に取り組むべきかを確認
uv run scripts/tasks.py list --status in-progress --table
uv run scripts/tasks.py list --limit 5 --table

# プロジェクトにリンクされたタスクを作成
uv run scripts/tasks.py create "Finish landing page" \
  --project "Website Redesign" \
  --priority high

# タスクを完了
uv run scripts/tasks.py update "Tasks/finish-landing-page.md" --status done
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

TaskNotes Skill

Manage Obsidian tasks via the TaskNotes plugin HTTP API.

Requirements

  1. TaskNotes plugin installed in Obsidian
  2. Enable HTTP API in TaskNotes settings:
    • Open Obsidian Settings → TaskNotes
    • Enable "HTTP API" toggle
    • Set API port (default: 8080)
    • API token: leave empty for no auth, or set a token for security
  3. Environment variables in .env file at vault root (if using auth):
    TASKNOTES_API_PORT=8080
TASKNOTES_API_KEY=your_token_here

    If TaskNotes has no auth token set, you don't need a .env file.

CLI Commands

# List all tasks
uv run scripts/tasks.py list

# List by status (use your configured status values)
uv run scripts/tasks.py list --status "in-progress"

# List by project
uv run scripts/tasks.py list --project "My Project"

# Create task
uv run scripts/tasks.py create "Task title" --project "My Project" --priority high

# Create task with scheduled time
uv run scripts/tasks.py create "Meeting prep" --scheduled "2025-01-15T14:00:00"

# Update task status
uv run scripts/tasks.py update "Tasks/task-file.md" --status done

# Add/update task description
uv run scripts/tasks.py update "Tasks/task-file.md" --details "Additional context here."

# Delete task
uv run scripts/tasks.py delete "Tasks/task-file.md"

# Get available options (statuses, priorities, projects)
uv run scripts/tasks.py options --table

# Human-readable output (add --table)
uv run scripts/tasks.py list --table

Task Properties

Status and Priority values: Configured in your TaskNotes plugin settings. Run options command to see available values:

uv run scripts/tasks.py options --table

Other fields:

  • projects - Array of project links, e.g. ["[[Project Name]]"]
  • contexts - Array like ["office", "energy-high"]
  • due - Due date (YYYY-MM-DD)
  • scheduled - Scheduled date/time (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS)
  • timeEstimate - Minutes (number)
  • tags - Array of tags
  • details - Task description (writes to markdown body, not frontmatter)

API Reference

Base URL: http://localhost:8080/api

Method Endpoint Description
GET /tasks List tasks (supports filters)
POST /tasks Create task
GET /tasks/{id} Get single task
PUT /tasks/{id} Update task
DELETE /tasks/{id} Delete task
GET /filter-options Available statuses, priorities, projects

Query Parameters for GET /tasks

  • status - Filter by status
  • project - Filter by project name
  • priority - Filter by priority
  • tag - Filter by tag
  • overdue - true/false
  • sort - Sort field
  • limit - Max results
  • offset - Pagination offset

When to Use

  • "create a task for X" → create task
  • "show my tasks" → list all tasks
  • "show in-progress tasks" → list --status in-progress
  • "mark X as done" → update task status to done
  • "what should I work on" → list tasks by status

Example Workflow

# Morning: Check what to work on
uv run scripts/tasks.py list --status in-progress --table
uv run scripts/tasks.py list --limit 5 --table

# Create task linked to project
uv run scripts/tasks.py create "Finish landing page" \
  --project "Website Redesign" \
  --priority high

# Complete a task
uv run scripts/tasks.py update "Tasks/finish-landing-page.md" --status done

同梱ファイル

※ ZIPに含まれるファイル一覧。`SKILL.md` 本体に加え、参考資料・サンプル・スクリプトが入っている場合があります。