# カレンダー

カレンダーの書き出しの仕組みを、接続から問題の解決まで。

## 接続

Exporter のホームでカレンダーの横にある「接続」を押し、続いて「カレンダーのフォルダを開く」を押します。ウインドウはカレンダーのフォルダ `~/Library/Group Containers/group.com.apple.calendar` で開くので、「このフォルダを選択」を押してください。続いてファイルの保存先を選び、「このフォルダを使う」を押します。

macOS はカレンダーのアクセス許可を求めず、Exporter も決して求めません。予定は許可されたフォルダの中のデータベースから読まれ、EventKit は使いません。ほかのアプリで見た許可ダイアログは、そちらの経路のものです。

## ファイルの置き場所

1 か月につき 1 つの Markdown ファイルが 1 つのフォルダに入ります: `2026-09.md`、`2026-10.md`。ホームフォルダの直下にあるフォルダ、たとえば `~/Documents` を選ぶと、その中に `calendar-export` フォルダができます。もっと深いフォルダ、たとえば `~/Documents/calendar` はそのまま使われます。予定のない月にファイルはできません。

## 書き出される範囲

カードでチェックされているカレンダーの予定すべて、設定された期間の中のもの。ピッカーはカレンダーのサイドバーと同じくアカウントごとにまとめるので、チェックを 1 つ外すだけでアカウントを除外できます。

予定は始まる月に、ちょうど 1 回だけ入ります。月末をまたいでも同じです。

## 繰り返し

繰り返す予定は、作られた日だけでなく、起きる日すべてに並びます。Exporter はカレンダーが自分の表示のために保持している出現を読むので、ファイルはアプリと一致し、どう繰り返すかが行に書かれます。

## 形式

常に Markdown です。月のフロントマター、続いて 1 日 1 見出しと予定ごとの 1 行。

1 日は終日の予定から始まり、そのあと開始時刻順に並びます。カレンダーが描く順番そのままです。終日の予定は「all day」と書かれ、無かった 00:00 を与えられることはありません。

## ファイルの中身

| キー | 内容 |
| --- | --- |
| `title`, `month` | 「カレンダー、2026年9月」と `2026-09` |
| `events` | そのファイルに入っている予定の件数 |
| `calendars` | その月のカレンダー、件数の多い順 |

1 行は、時刻、予定、出どころのカレンダー、場所。そのあとに vault が問い合わせられるフィールドが続きます。

| フィールド | 内容 |
| --- | --- |
| `repeats::` | `daily`、`weekly`、`every 2 weeks` |
| `join::` | ビデオ通話のリンク（予定にあるとき） |
| `with::` | 参加人数 |

```markdown
## 2026-09-17, 木曜日

- all day マリリンの誕生日 · 誕生日
- 09:30-10:00 スタンドアップ · 仕事 · Zoom [repeats:: weekly] [with:: 6]
- 13:00-14:00 ケビンとランチ · プライベート · Philz Coffee
```

## どこまで遡るか

カードの「reads」の行: 今年、2 年、5 年、すべて。書き出されるファイルが変わるので、期間を狭めれば書き出しも小さくなります。

カレンダーが自分の表示のために保持している出現はおよそ 2 年分で、読めるのはそこまでです。実機では 2 年、5 年、すべてのいずれでも同じ予定が返ります。「すべて」とはこの Mac にあるすべてであって、これまでに起きたすべてではありません。

## 無料と解除

最初の 100 件は無料で、そのままです。カレンダーを解除すると残りも書き出されます（[価格](https://exporter.dev/pricing)）。

## 同期と全体の再同期

最初の「sync now」のあとは、月の中身が変わったときにその月だけが書き直されます。頻度は多くても 1 分に 1 回です。予定を動かすと、その予定の月だけが書き直されます。

「full resync」は先に確認してから、Exporter が書いた月ファイルを削除し、チェックされているカレンダーをすべて書き直します。フォルダ内のそれ以外のものは残ります。

## 困ったとき

- 「no calendar database in that folder (pick the Calendar folder itself)」: もう一度「connect」を押し、ウインドウが開いたそのフォルダを選んでください
- カレンダーが足りない: カードでチェックが外れているか、そのアカウントごと外れています。ピッカーはアカウントごとにまとめています
- 古い予定がない: 「reads」の行が短い期間になっているか、カレンダー自身がもう保持していません
- リマインダーが書き出しに混じる: カレンダーは予定表のリマインダーを独立したカレンダーとして表示します。カードで「Reminders」アカウントのチェックを外してください

## Related

- [カレンダー](https://exporter.dev/ja/calendar): 1 か月が 1 つの Markdown ファイル
- [リマインダー](https://exporter.dev/ja/docs/reminders): リストファイル、項目、対処法
- [MCP サーバー](https://exporter.dev/ja/docs/mcp): Claude やほかのエージェントを接続

---

human version: https://exporter.dev/ja/docs/calendar
every page: https://exporter.dev/llms.txt