Use Obsidian with Take Toucan

What you'll get

A dedicated Obsidian vault for Take Toucan scripts, separate from your personal notes. Write .md files by hand, link between drafts, and keep script ideas organized. No AI required.

Before you start

• Take Toucan installed on iPhone or iPad, with onboarding completed at least once. On first launch, the app seeds your folder with a README, a demo script, and AI instruction files.
• iCloud Drive enabled on all devices: Settings → [your name] → iCloud → iCloud Drive → On. Use the same Apple ID on Mac and iPhone.
• Open Take Toucan on iPhone once so the folder is created. On Mac, wait for iCloud to sync. Finder may show a cloud icon until download completes.
• Desktop tools (Cursor, Codex, Claude Code, Obsidian) connect on Mac only. Never paste an iPhone filesystem path on your Mac. Use the Mac path from the app or the paths below.

Find your scripts folder

Take Toucan stores scripts in iCloud Drive. The folder you connect to any writing tool is the Documents subfolder inside Take Toucan.

1. Finder sidebar: Finder → iCloud Drive → Take Toucan → Documents.
2. Go to Folder: Finder → Go → Go to Folder (⌘⇧G), then paste the path below.
3. From the iPhone app: Take Toucan → Dashboard or Settings → Scripts folder → Copy Mac path. Paste into Finder or your tool's open-folder dialog.

~/Library/Mobile Documents/iCloud~co~uk~designaway~TakeToucanV2/Documents

You can also open ~/Library/Mobile Documents/com~apple~CloudDocs/Take Toucan in Finder and navigate to Documents.

[Screenshot: Finder → iCloud Drive → Take Toucan]

If you do not see agent files like AGENTS.md or CLAUDE.md, enable View → Show Hidden Files in Finder (⌘⇧.). AI tools can still read them when the Documents folder is the project root.

Download Obsidian

1. On your Mac, download Obsidian from obsidian.md.
2. Install Obsidian and open it from your Applications folder.

[Screenshot: Obsidian download]

Connect Obsidian to the folder

1. Open Obsidian on your Mac.
2. At the vault switcher, choose Open folder as vault (or Open another vault → Open folder as vault on first launch).
3. Navigate to your Take Toucan Documents folder, or paste the path below.
4. Click Open. Obsidian creates a vault rooted in that folder.
5. Optional: rename the vault to Take Toucan in Obsidian's vault list for quick switching.

Use the Documents subfolder, not the parent Take Toucan iCloud container. That matches how Cursor, Codex, and Claude Code connect and keeps your scripts in one flat folder.

Copy-paste path:

~/Library/Mobile Documents/iCloud~co~uk~designaway~TakeToucanV2/Documents

[Screenshot: Obsidian vault switcher with Take Toucan vault]

Writing tips in Obsidian

• Each .md file becomes a script title in Take Toucan. Use clear filenames like Hook for Tuesday.md.
• Write spoken prose in the body. Avoid bullet outlines, section labels like HOOK:, or stage directions.
• Use underscore-prefixed files for drafts and notes that should stay out of the app, such as _ideas.md or _notes.md.
• Keep script files directly in Documents, not in subfolders. Take Toucan reads a flat folder.
• Link between drafts with Obsidian wikilinks if that helps your workflow. The app shows the file body as your script.

Write your first script

Create a new file named Why I press record.md in your Documents folder. Use plain spoken prose:

I used to wait until I felt ready on camera.

Now I press record before I feel ready, because waiting was the whole problem.

One messy take beats another week of planning.

Save the file, wait for iCloud sync, then open Take Toucan on iPhone and record.

Optional: AI plugins

Obsidian has community plugins that can assist with writing. Take Toucan does not require or endorse a specific plugin. If you use one, make sure it saves .md files into your Documents vault folder.

For AI that writes files into your folder by default, see the guides for Cursor, Codex, or Claude Code. Obsidian shines for manual writing and organizing ideas.

Sync back to Take Toucan

1. Save your .md file in the Documents folder on Mac.
2. Wait for iCloud to sync (usually seconds to a minute).
3. Open Take Toucan on iPhone and pull to refresh on the dashboard.
4. Your script appears. Tap it and record with the teleprompter.

Troubleshooting