Tasks Database

The tasks database is the core of CueCapture. This guide shows you how to connect your existing Notion tasks database or create a new one optimized for CueCapture.

Prerequisites

Before starting:

• You’ve set up your Notion API key
• You have a Notion database with tasks (or will create one)

Connecting Your Database

1. Share the Database

   In Notion, open your tasks database and share it with your integration:

   • Click ”…” in the top right
   • Select “Connections”
   • Add your CueCapture integration

2. Copy the Database URL

   Copy the URL from your browser when viewing the database. It looks like:

   https://notion.so/workspace/abc123def456...

3. Paste in CueCapture

   Open CueCapture settings → Notion Databases → Tasks Database and paste the URL.

   CueCapture will automatically extract the database ID and read its schema.

4. Map Properties

   CueCapture will show your database properties. Map them to CueCapture fields:

   CueCapture Field	Your Property	Required
   Task Name	Title property	✅ Yes
   Status	Status/Select/Checkbox	✅ Yes
   Due Date	Date property	Optional
   Priority	Select property	Optional
   Project	Relation property	Optional

Required Properties

Your database must have these properties:

Task Name (Title)

Every Notion database has a title property. This is your task name.

Status

CueCapture supports multiple status formats:

Checkbox

A simple checkbox property. Checked = complete.

• ✅ Simplest option
• ❌ No “in progress” or other states

Status Property

Notion’s built-in status property with To-do, In progress, Complete groups.

• ✅ Rich status tracking
• ✅ Works great with Notion’s built-in features

Select Property

A select property with options like “To Do”, “In Progress”, “Done”.

• ✅ Flexible custom statuses
• ✅ Works with existing databases

Optional Properties

These properties enhance CueCapture but aren’t required:

Due Date

A date property for task deadlines. CueCapture will:

• Show due dates in the task list
• Highlight overdue tasks
• Let you filter by date

Priority

A select property with priority levels (e.g., “High”, “Medium”, “Low”). Used for:

• Sorting tasks by priority
• Eisenhower Matrix quadrant mapping

Project (Relation)

A relation property linking to a Projects database. Enables:

• Task grouping by project
• Project progress tracking
• Project-based filtering

Eisenhower Properties

For the Eisenhower Matrix feature, you can add:

• Urgent: Checkbox property
• Important: Checkbox property

Or use a single select property with options like “Urgent & Important”, “Not Urgent & Important”, etc.

Database Templates

Starting Fresh?

Here’s a recommended database structure:

Property	Type	Options
Task	Title	–
Status	Status	To-do, In progress, Complete
Due	Date	–
Priority	Select	🔴 High, 🟡 Medium, 🟢 Low
Project	Relation	→ Projects database
Urgent	Checkbox	–
Important	Checkbox	–
Time Spent	Number	Minutes format

Using an Existing Database?

CueCapture works with most existing task databases. Common compatible templates:

• Notion’s official Tasks template
• GTD (Getting Things Done) templates
• Kanban board databases
• Simple to-do lists

Property Mapping Tips

Status Mapping

Tell CueCapture which status values mean “complete”:

Completed Statuses: Done, Complete, ✅, Finished

CueCapture treats any task with these statuses as complete and can hide them from the main view.

Custom Status Icons

If your statuses use emojis (📋, 🔄, ✅), CueCapture will display them. Configure the “Display name” in settings to clean up the display.

Syncing Behavior

Initial Import

When you first connect, CueCapture imports all tasks from your database. Large databases (1000+ tasks) may take a minute.

Ongoing Sync

• CueCapture → Notion: Changes sync immediately (within seconds)
• Notion → CueCapture: Changes sync on widget focus or manual refresh
• Poll interval: Configurable in settings (default: 30 seconds)

Note

For real-time Notion → CueCapture sync, you can set up webhooks. This is an advanced feature - see the webhook documentation for details.

Troubleshooting

”Database not found”

• Verify you’ve shared the database with your integration
• Check the URL is correct and from the right workspace

”Missing required property”

• Ensure your database has a title property and status property
• Re-map properties in CueCapture settings

Tasks not appearing

• Check your filter settings in CueCapture
• Verify the tasks exist in Notion
• Try the “Refresh” button or restart CueCapture

Status not syncing correctly

• Verify status property mapping in settings
• Check “Completed statuses” configuration
• Ensure the property type matches what you selected

Next Steps

• Projects Database - Optional: Group tasks by project
• Time Logs Database - Optional: Track time on tasks