Use Cursor with Take Toucan

What you'll get

Cursor as your script writing workspace. Create and edit .md files in your iCloud folder, with AI that reads your Take Toucan instruction files when the Documents folder is the project root.

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 Cursor

1. On your Mac, download Cursor from cursor.com.
2. Install Cursor and open it from your Applications folder.
3. Sign in or create an account if prompted.

[Screenshot: Cursor download and sign-in]

Connect Cursor to the folder

Open the Documents folder as your project root, not the parent Take Toucan container. That keeps agent files like AGENTS.md and TAKE_TOUCAN_SCRIPT_RULES.md at the top level where Cursor's AI can find them.

1. Open Cursor on your Mac.
2. Choose File → Open Folder.
3. Navigate to iCloud Drive → Take Toucan → Documents, or paste the path below in the dialog.
4. Click Open. Cursor treats this folder as your project.

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

[Screenshot: Cursor with the Documents folder open as a project]

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: use AI in this folder

With the Documents folder open, Cursor's AI can read your instruction files and create new scripts. Try a prompt like:

Read TAKE_TOUCAN_SCRIPT_RULES.md and VOICE.md, then create a 150-word Take Toucan script called My First Idea.md. Plain spoken prose only, no stage directions.

You can also write scripts manually in Cursor without AI. Any .md file you save in Documents will sync to Take Toucan.

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