Step 1 of 3
Open Code
Open the Claude desktop app and choose the Code tab, not Home or browser chat.
Take ToucanHomeHelp
Use Claude Code with Take Toucan
Open a local Claude Code session in your Take Toucan folder so Claude can follow your voice guide and write scripts directly into iCloud.
What you’ll get
Claude Code can work locally in the folder, read CLAUDE.md, and save finished scripts where Take Toucan can find them.
Take Toucan does not require its own Mac app. You are connecting the Mac app you already write with to one iCloud folder.
On your Mac
Follow the screenshots
Keep this page open on your phone or another window while you complete each action on your Mac.
Step 2 of 3
Start a local session
Create a new session, choose Local, then open the project-folder control.
Step 3 of 3
Choose Take Toucan
In the folder picker, choose Take Toucan under iCloud Drive, then choose Open. The app may show the opened folder as Documents.
Final check
Can you see the Take Toucan files?
Your setup is complete when the writing tool can see:
- Demo — Present Over Perfect.md
- VOICE.md
- CLAUDE.md
Nothing is copied or moved. Your Mac and iPhone are looking at the same files through iCloud.
Try it now
Give your assistant a useful first job
Copy one of these short instructions into the Mac app. The files already explain how Take Toucan works.
Learn my voice
The assistant reads the Take Toucan rules and VOICE.md, then asks a few short questions to learn your durable preferences.
Write my first script
The assistant asks for your topic, audience, and key point, then saves the finished script into the opened folder.
Give me content ideas
The assistant asks about your topic and audience, then suggests ideas using the context in your Take Toucan folder.
Need the app?
Install the Claude desktop app and sign in. Claude Code requires a plan that includes Code.
Download Claude for Mac ↗Reference
Advanced help
You should not need paths or troubleshooting for the normal setup. They are here if iCloud or a folder picker behaves unexpectedly.
Before you start
- Open Take Toucan on iPhone at least once so it can create the folder and starter files.
- Turn on iCloud Drive on the iPhone and Mac, and use the same Apple Account on both.
- Wait for iCloud to finish syncing. Finder may briefly show a cloud icon beside Take Toucan.
- Complete these steps in a Mac writing tool. Take Toucan itself does not require a Mac app.
The folder’s technical Mac path
Finder deliberately presents the app container as iCloud Drive › Take Toucan. Some writing tools expose its internal working folder name, Documents. They refer to the same iCloud-backed folder.
~/Library/Mobile Documents/iCloud~co~uk~designaway~TakeToucanV2/DocumentsUse the technical path only with Finder’s Go to Folder command (⌘⇧G) when the normal iCloud Drive picker is unavailable.
What Take Toucan puts in the folder
| File | Purpose |
|---|---|
| README.md | Human-readable intro to the workflow |
| Demo — Present Over Perfect.md | Example script to try recording |
| VOICE.md | Your editable voice and tone guide for AI |
| TAKE_TOUCAN_SCRIPT_RULES.md | App-managed script format rules |
| AGENTS.md | Instructions for Codex-style agents |
| CLAUDE.md | Imports rules for Claude Code |
| Your *.md files | Your scripts |
Troubleshooting and sync recovery
Folder doesn't appear in Finder
Confirm iCloud Drive is on, open Take Toucan on iPhone once, wait for sync, and check you're signed into the same Apple ID.
Take Toucan missing under iCloud Drive
Open the iPhone app once, confirm iCloud Drive is enabled for Take Toucan, and give Finder a moment to sync.
The writing tool calls the folder Documents
That is expected. Finder presents iCloud Drive › Take Toucan, while some folder pickers expose the app container's working folder as Documents. They are the same iCloud-backed folder.
Scripts don't show on iPhone
Confirm the file is .md (not .txt), not a reserved name (README.md, VOICE.md, _*.md, AGENTS.md), and pull to refresh on the dashboard.
AI created a file but the app doesn't see it
Files must be directly in the opened Take Toucan folder, not in a subfolder.
Edits not syncing
Check iCloud status and avoid editing the same file on two Macs before sync completes.
Normal sync sequence
- Save your .md file directly in the opened Take Toucan folder on Mac.
- Wait for iCloud to sync (usually seconds to a minute).
- Open Take Toucan on iPhone and pull to refresh on the dashboard.
- Your script appears. Tap it and record with the teleprompter.
Related guides
Still need help?
Send us a message from the support page.