Fantasticalのタスク連携ガイド（Todoist・iCloud・Microsoft・CalDAV）

クイックスタート：Fantasticalでタスクを最短で接続する方法

まず最短で接続するための手順だけを示します。詳細な制限やバックアップ手順、トラブル対応は続くセクションで解説します。

最短で接続する手順

以下は最短手順です。各項目は端末のローカライズ（英語/日本語表記）を併記しています。

1. Fantastical を最新版にアップデートする。

2. App Store（App Store） / Microsoft Store（Microsoft Store） / 公式サイトから更新してください。

3. Fantastical のアカウント設定を開く。

4. iOS/iPadOS：Fantastical → 下タブの Settings（設定） → Accounts（アカウント）。
5. macOS：Fantastical → Preferences（環境設定） → Accounts（アカウント）。

6. Windows：Fantastical アプリ → Settings（設定）→ Accounts（アカウント）。

7. Add Account（アカウントを追加）を選び、接続したいサービス（Todoist / iCloud / Microsoft / CalDAV など）を選択する。

8. OAuth が表示されたらログインして権限を許可します（ログイン画面はサービスの言語表示になります）。

9. 接続後、表示トグルで同期するリストやプロジェクトを有効にする。

10. Fantastical のサイドバーで表示/非表示を切り替え、テストタスクで反映を確認します。

11. テストタスクを1件作成して双方向での反映を確認する。

12. 片方でタイトル・期日・完了の変更を行い、もう片方に反映されるかを検証します。

13. 問題があればログを取得してサポートへ連絡する（ログの取り方は後述）。

14. Flexibits（Fantastical の開発元）サポートページを参照してください（サポートへの提出情報を揃えておくと対応が早くなります）。

対応サービスとサポートの概略

ここではFantasticalが実務で連携する主なタスクサービスの概略を示します。後続セクションでサービス別の詳細と公式出典を付けます。

主な対応サービス（概略）

以下は代表的な接続先と実務想定のサポートレベルです。具体的なフィールドや制約はサービスやバージョンによって変わるため、接続前に公式ドキュメントで最新情報を確認してください。

サービス別の公式出典（主要）

各主張の根拠として参照すべき公式ドキュメントを示します。記載の「最終確認日」は当該ページを参照した日付です。各リンク先で最新情報を必ずご確認ください。

• Fantastical（Flexibits 公式）：https://flexibits.com/fantastical

• 最終確認日：2026-05-17（Fantastical の一般的な機能と連携概要）

• Todoist（公式ヘルプ / API）：

• ヘルプセンター（一般ヘルプ）: https://get.todoist.help/hc/en-us
• API（REST v2）: https://developer.todoist.com/rest/v2/
• Reminders（リマインダーは有料条件がある旨の案内）: https://get.todoist.help/hc/en-us/articles/205248842-Reminders

• 最終確認日：2026-05-17

• Apple Reminders / iCloud（公式サポート）：

• Reminders の使い方（Apple サポート）: https://support.apple.com/guide/iphone/reminders-iph3b8f7a/ios
• iCloud バックアップ（デバイス全体のバックアップ）: https://support.apple.com/guide/iphone/backup-your-iphone-iph3bd8a4f/ios
• App-specific passwords（2 要素認証とアプリ用パスワード）: https://support.apple.com/en-us/HT204397

• 最終確認日：2026-05-17

• Microsoft 365 / Microsoft To Do / Azure AD（公式ドキュメント）：

• Microsoft To Do サポート: https://support.microsoft.com/office/microsoft-to-do
• Exchange / Outlook のエクスポート（PST など）: https://support.microsoft.com/office/export-or-backup-outlook-to-a-pst-file-1424
• Azure AD 条件付きアクセス: https://learn.microsoft.com/azure/active-directory/conditional-access/

• 最終確認日：2026-05-17

• CalDAV / VTODO（標準仕様）:

• CalDAV（RFC 4791）: https://tools.ietf.org/html/rfc4791
• iCalendar / VTODO（RFC 5545）: https://tools.ietf.org/html/rfc5545
• Nextcloud Tasks（Nextcloud のドキュメント）: https://docs.nextcloud.com/server/latest/user_manual/pim/tasks.html
• 最終確認日：2026-05-17

注：外部の非公式手順サイト（例: app-tatsujin.com 等）を参照する場合は必ず「非公式」である旨を明示し、公式ドキュメントと照合してください。

同期される項目とサービス間の差異

ここでは「何が双方向で反映されやすいか」と「サービス間で差が出やすい項目」を整理します。実際の挙動はバージョンやアカウント種別で変わるため、テストと公式確認を必ず行ってください。

共通して同期されやすい項目

以下は多くの組み合わせで双方向に反映されやすいフィールドです。

• タイトル（タスク名）
• 期日（日時を含む場合の時刻）
• 完了状態（チェック済み／未完了）
• 基本的なメモ／説明（サービスによって切り捨てや分割あり）
• 繰り返しルールの基本形（ただし複雑なルールは変換されることがある）

これらは多くの API・CalDAV 実装で共通してサポートされますが、細部は各サービスの仕様に依存します（出典参照）。

サービス間で扱いが分かれる項目

次の項目はサービス間で差が出やすく、運用方針を決めてから連携することを推奨します。

• コメント（例：Todoist のコメントは API に存在するが、Fantastical が表示しない場合がある）
• 参照：Todoist API（https://developer.todoist.com/rest/v2/） 最終確認日：2026-05-17
• 添付ファイル（一般に同期されないことが多い）
• ラベル／タグ／プロジェクトの完全なマッピング（表現の差で失われることがある）
• サブタスクの親子関係（階層が崩れる・フラット化される場合あり）
• リマインダー通知（サービス固有の通知機構や有料条件に依存）

簡潔に言うと、タイトル／期日／完了は期待できる一方で、コメント・添付・複雑な階層・プレミアム機能は事前テストが必須です。

Todoistとの連携 — 実務で押さえるべき制限と具体例

Todoist は多機能かつ API が充実しているため、運用次第で挙動差が出やすい代表例です。ここでは具体的なフィールド例、Premium 依存挙動、バックアップ手順などを示します。

フィールド別マッピング（具体例）

下表は実務でよく問題になるフィールドをまとめた例示です。各項目は「一般的な期待値」と「注意点」を示します。必ずテストで挙動を確認してください。

注：上表の「出典」は Todoist の公式 API / ヘルプを参照しています。Fantastical 側での表示ルールは Flexibits の統合実装に依存するため、必要に応じて Flexibits のサポート情報も確認してください（https://flexibits.com/fantastical、最終確認日:2026-05-17）。

Premium 依存の機能（Todoist）

Todoist の一部機能は有料プランに依存します。代表的なものは以下です。

• プッシュリマインダー（モバイル通知等）は Premium の条件がある。
• 参照：Todoist ヘルプ — Reminders（https://get.todoist.help/hc/en-us/articles/205248842-Reminders、最終確認日:2026-05-17）

Fantastical 側で通知を受けたい場合は、どの通知をどちらのアプリに任せるか運用ルールを決めておくと混乱が減ります。

サブタスクや階層の扱い・移行の実務例

実務で多いケースと推奨対応例です。

• 事例：Todoist で「親タスク → 子タスク1, 子タスク2（更に孫タスク）」の多階層構成を持つ。
• 想定挙動：Fantastical が一部の階層をフラット化して表示する可能性があります。
• 対処例：階層を維持したい重要タスクは Todoist ネイティブで管理。移行時は API エクスポート→インポートで親子IDを維持するスクリプトを使う。

サンプル（Todoist REST API でタスクを取得する例）：

• 取得した JSON に parent_id（親タスクID）が含まれるので、移行先でこの値を活用して階層を再構築します。
• コピーやインポート時はタスクIDが変わるため、ID の再マッピングが必要です。

Todoist のバックアップ／エクスポート手順（実務向け）

バックアップ例を示します。まずは API を使う方法が確実です。

• Web UI（簡易）: Todoist の設定 > Integrations / Projects ごとのエクスポート（UI により利用可否が変わる）を確認。
• REST API（推奨）: API トークンを取得し、/tasks エンドポイントでタスク一覧を JSON 出力する。
• API トークンは Todoist の Settings（設定）→ Integrations（統合）等で確認可能です（https://developer.todoist.com/rest/v2/、最終確認日:2026-05-17）。
• cURL サンプル（上記参照）で JSON 保存を行い、必要ならスクリプトで parent_id を保持した形の CSV に変換します。

注意：Web UI のエクスポート機能はアカウントの種類や UI の更新で表示が変わるため、API を使ったバックアップが確実です。

接続前チェックとバックアップ（必須）

作業前に行うべき必須チェックリストと、各サービスごとのバックアップ手順を具体的に示します。再認証やアカウント削除はデータ消失リスクがあるため、必ずバックアップを取得してから実行してください。

共通の注意事項（まとめ）

• 重大な操作（アカウント削除／再認証／移行）は必ず事前にバックアップを取得すること。
• テスト用の小規模タスクで双方向の動作確認を行うこと。
• 管理対象アカウント（仕事用／個人用）は混在させず、1つの「真実のソース」を定めること。
• 公式ドキュメントの最終確認日を明記しておくと、将来の差異把握に役立ちます。

各サービスのエクスポート手順（要点）

以下は代表的な方法です。詳細手順は各公式ページを参照してください。

Todoist（エクスポート例）

• API を利用してタスクを JSON で取得するのが確実。
• エンドポイント: GET https://api.todoist.com/rest/v2/tasks（Authorization: Bearer ）
• 参照：Todoist REST API（https://developer.todoist.com/rest/v2/、最終確認日:2026-05-17）

iCloud / Reminders（エクスポート例）

• Apple は Reminders の単体エクスポート機能を限定的に提供しているため、次の方法を推奨します。
• macOS を利用できる場合は Time Machine で Reminders アプリのバックアップを取得する。
• デバイス全体のバックアップ：iCloud バックアップまたは Finder/iTunes バックアップを利用する。
• Apple の公式サポート（iCloud / バックアップ）を参照してください（https://support.apple.com、最終確認日:2026-05-17）。
• 注意：リスト単位でのエクスポートが必要な場合は、サードパーティツールや AppleScript の利用を検討してください（非公式）。

Microsoft 365 / Exchange / To Do（エクスポート例）

• Outlook デスクトップを利用してタスクを PST にエクスポートする方法が一般的です。
• Outlook の「File（ファイル）」→「Open & Export（開く／エクスポート）」→「Import/Export（インポート／エクスポート）」から PST を作成。
• 管理者がいる組織では管理ポリシーに従ってエクスポートを行ってください。
• 参照：Microsoft サポート（Export Outlook items to a PST file、最終確認日:2026-05-17）

CalDAV / Nextcloud（エクスポート例）

• Nextcloud の Tasks アプリや CalDAV クライアント経由で VTODO／iCal 形式でのエクスポートが可能な場合があります。
• 参照：Nextcloud ドキュメント（https://docs.nextcloud.com/server/latest/user_manual/pim/tasks.html、最終確認日:2026-05-17）

再認証・アカウント削除の安全手順

再認証やアカウントの削除はトークンや保存先に影響します。以下は安全に実施するための一般的手順です。必ずバックアップを取得してから作業してください。

再認証の前に行うべき作業

1. 各サービスのバックアップを取得する（上段参照）。
2. Fantastical で表示トグル（対象のリストが表示状態か）を確認し、スクリーンショットを取得する。
3. 問題発生時に提出するための情報（アカウントメール、影響タスクの ID / タイトル、再現手順）を控える。

再認証の一般的な流れ（安全手順）

1. バックアップを完了する。
2. Fantastical の設定 → Accounts（アカウント）で対象アカウントを一時的にオフにするか、削除する。
3. macOS：Fantastical → Preferences（環境設定）→ Accounts（アカウント）→ 該当アカウント → Remove（削除）
4. iOS：Settings（設定）→ Accounts（アカウント）→ Remove Account（アカウントを削除）
5. 必要ならサービス側（Todoist / Microsoft / iCloud）の連携ページで Fantastical のアクセスを取り消す（OAuth の取り消し）。
6. Fantastical で Add Account（アカウントを追加）して再度 OAuth 認証を行う。
7. テストタスクで双方向同期を検証する。

アカウント削除時の注意

• 削除／再追加の操作がサービス側のデータに影響するケースは限定的ですが、同期の競合や重複が発生することがあります。バックアップと小規模テストを必ず行ってください。
• 組織アカウントでは管理者側の連携ポリシーで再接続できない場合があります。管理者へ確認してください。

トラブルシューティング：同期競合・ログ取得・サポートへの提出情報

このセクションは実務で問題を切り分け、サポートに報告するための手順と必須情報を示します。特に「どちらの変更が勝つか（優先ルール）」や「ログの種類と取得方法」を明確にします。

同期競合の優先ルール（一般論とサービス別の傾向）

• 一般論：多くのシステムは最終更新時刻（last-modified）を用いる「ラストライター勝ち」方式を採ることが多いです。ただし実装差やネットワーク遅延により挙動が異なるため注意が必要です。
• Todoist：Sync API/REST API の更新フローに基づき、サーバ側のタイムスタンプや sync_token で差分管理されます。詳しくは Todoist の開発者向けドキュメントを参照してください（https://developer.todoist.com/、最終確認日:2026-05-17）。
• CalDAV：RFC 仕様（ETag／ETag による競合検知や PUT の結果）に従います。サーバ実装によっては上書きやマージの挙動が変わります（RFC 4791、最終確認日:2026-05-17）。
• iCloud Reminders：iCloud の同期メカニズムが優先されるため、端末のローカル変更とサーバ側の最終更新日時で解決されます。Apple の仕様に従います（Apple サポート参照、最終確認日:2026-05-17）。
• Microsoft：Exchange / Microsoft 365 はサーバの変更管理に従い、最後にサーバに到達した変更が残ることが多いです。条件付きアクセス等で同期がブロックされると矛盾が生じます（Azure AD ドキュメント参照、最終確認日:2026-05-17）。

実務対応：競合が疑われる場合は、該当タスクの「両側の最終更新日時」を比較し、どちらを正とするかを決めてから片方を上書きする運用ルールを設けると安定します。

ログ・診断情報の取得とサポートへの提出（Fantastical / Todoist / Microsoft / iCloud）

サポートに送るときに必要な情報と取得手順の例を示します。英語/日本語 UI 名を併記します。

必須で揃える情報（テンプレ）：

• 使用している Fantastical のバージョン（例: Fantastical 3.x）
• OS・バージョン（macOS / iOS / Windows）
• 発生日時（タイムゾーン明記）と再現手順（ステップ）
• 影響タスクのタイトル、可能であればタスク ID（サービス側の ID）
• 取得したログやエクスポートファイル（todoist_tasks.json など）
• スクリーンショット（設定画面、アカウント画面、表示の差分）

Fantastical の診断ログ取得（目安）：

• macOS：Fantastical メニュー → Help（ヘルプ） → Send Diagnostics（診断情報を送信）または Support（サポート）案内に従う。
• iOS：Fantastical アプリの Settings（設定）→ Help & Support（ヘルプとサポート）→ Send Diagnostics（診断情報を送信）等の項目を確認。
• 送信前に、サポートに添える説明（挙動・日時・再現手順）をメモしておくと対応が早くなります。
• 参考：Flexibits サポート（https://flexibits.com/support、最終確認日:2026-05-17）

サービス別ログ例：

• Todoist：API を使って問題タスクを取得し、JSON を添付するとデバッグが早い（/tasks エンドポイントで取得）。
• Microsoft / Azure AD：組織アカウントの場合、管理者にサインインログや条件付きアクセスのログを取得してもらう。Azure Portal のサインインログは重要。
• iCloud：macOS の Console.app でシステムログ（Fantastical や iCloud 関連のエラー）を抽出し、.txt 化して添付する。

機密情報の扱い：ログ送付時に API トークンやパスワードは送らないでください。必要な場合はサポートの指示に従い、安全なチャネル（サポートポータル経由など）で提供します。

サポートに送る際の必須情報（Flexibits 向けの例）

1. Fantastical のバージョンと OS バージョン。
2. 問題の再現手順。
3. 影響タスクのスクリーンショット（両側の表示）とタスクタイトル。
4. Fantastical の診断ログ（アプリ内から送信）またはダウンロードしたログファイル。
5. 可能なら Todoist / Microsoft などでエクスポートした該当タスクの JSON/CSV を添付。

Flexibits サポートページ： https://flexibits.com/support（最終確認日:2026-05-17）

運用ワークフローと移行ケース（実務例）

運用でよく出るケースと推奨ワークフローを示します。特に大量移行やサブタスクの扱いなどについて実務的な手順を提示します。

個人利用のシンプル運用例

• 真実のソースを1つ決める（例：Todoist をソースにして Fantastical はビューと一部編集用）。
• Todoist でプロジェクト管理し、Fantastical は期日の集約とカレンダーへの表示に使う。
• 通知はどちらに任せるかを明確にする（OS 通知は二重にならないように注意）。

チーム／組織向け運用例

• チーム管理は Microsoft To Do / Planner / Exchange を中心にし、個人は Fantastical で自分の締切を集約する。
• 共有ルールを文書化し、コメントや添付はサービスネイティブで運用する（同期のズレを回避するため）。

大量移行・サブタスク維持の手順（例）

1. 移行元（例：Todoist）から API で JSON をエクスポートし、親子関係（parent_id）を確認する。
2. 変換スクリプトで移行先の API 仕様に合わせて JSON を整形する（親子 ID をマッピングして再作成）。
3. 少量ずつインポートして、期待通りの階層が保たれるかを確認する。
4. 最終確認後に一括インポート。問題発生時は元データに戻せるようにバックアップを保管する。

よくある質問（FAQ）

複数の Todoist アカウントは追加できますか？

Fantastical は複数アカウントを追加できる場合が多いです。表示やデフォルト保存先に注意して運用してください。

サブタスク（親子関係）はどう同期されますか？

基本は同期されますが、階層が崩れることがあります。階層の維持が重要なら、移行や編集は Todoist ネイティブで行うことを推奨します。参照：Todoist API（最終確認日:2026-05-17）。

繰り返しタスクはどう変換されますか？

基本的な繰り返しは反映されますが、複雑な繰り返しルールは変換される可能性があります。事前にサンプルで検証してください。

Fantastical で編集したときサービス側に反映されますか？

タイトル・期日・完了等の基本フィールドは原則双方向で反映されます。ただしコメントや添付など一部フィールドは反映されないことがあります。実運用前に必ずテストしてください。

参考・公式リンク集（主要）

以下は本文で参照した主要な公式ドキュメントです。各ページの内容は随時変更されるため、リンク先で最新情報を確認してください。各リンクの最終確認日は併記しています。

• Fantastical（Flexibits 公式）: https://flexibits.com/fantastical — 最終確認日: 2026-05-17
• Flexibits サポート（Fantastical の診断／サポート窓口）: https://flexibits.com/support — 最終確認日: 2026-05-17
• Todoist ヘルプセンター: https://get.todoist.help/hc/en-us — 最終確認日: 2026-05-17
• Todoist API（REST v2）: https://developer.todoist.com/rest/v2/ — 最終確認日: 2026-05-17
• Todoist — Reminders（リマインダー関連）: https://get.todoist.help/hc/en-us/articles/205248842-Reminders — 最終確認日: 2026-05-17
• Apple Reminders（Apple サポート）: https://support.apple.com/guide/iphone/reminders-iph3b8f7a/ios — 最終確認日: 2026-05-17
• Apple — iCloud / バックアップ関連: https://support.apple.com — 最終確認日: 2026-05-17
• Apple — App-specific passwords（2 段階認証のアプリ用パスワード）: https://support.apple.com/en-us/HT204397 — 最終確認日: 2026-05-17
• Microsoft To Do（サポート）: https://support.microsoft.com/office/microsoft-to-do — 最終確認日: 2026-05-17
• Microsoft — Outlook / エクスポート（PST）: https://support.microsoft.com/office/export-or-backup-outlook-to-a-pst-file-1424 — 最終確認日: 2026-05-17
• Azure AD — 条件付きアクセス: https://learn.microsoft.com/azure/active-directory/conditional-access/ — 最終確認日: 2026-05-17
• CalDAV / RFC 4791（仕様）: https://tools.ietf.org/html/rfc4791 — 最終確認日: 2026-05-17
• iCalendar / RFC 5545（VTODO）: https://tools.ietf.org/html/rfc5545 — 最終確認日: 2026-05-17
• Nextcloud Tasks（ドキュメント）: https://docs.nextcloud.com/server/latest/user_manual/pim/tasks.html — 最終確認日: 2026-05-17

非公式情報に関する注意：本文で触れたサードパーティの手順メモ等（例：app-tatsujin.com）は非公式情報です。これらは参考情報として扱い、最終判断は必ず公式ドキュメントで行ってください。

このガイドは実務で安全かつ再現性のある接続・運用を目指すための手順を中心にまとめました。作業前はまずバックアップと小規模なテストを行い、問題発生時は上記のログ収集手順に従ってサポートに連絡してください。