Task Sync

v2.0.3

Synchronize TickTick (Dida) and Google Tasks bidirectionally, including list/project mapping, task content sync, completion sync, and smart-list export (Today, Next 7 Days, All). Use when users ask to set up OAuth, run or schedule sync, fix mismatched/deleted/completed tasks, or troubleshoot Google Calendar duplicate behavior caused by due-date handling.

1· 1.4k·2 current·2 all-time
byJiapeng Chen@jp1222

Install

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for jp1222/task-sync.

Previewing Install & Setup.
Prompt PreviewInstall & Setup
Install the skill "Task Sync" (jp1222/task-sync) from ClawHub.
Skill page: https://clawhub.ai/jp1222/task-sync
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Canonical install target

openclaw skills install jp1222/task-sync

ClawHub CLI

Package manager switcher

npx clawhub@latest install task-sync
Security Scan
VirusTotalVirusTotal
Benign
View report →

Like a lobster shell, security has layers — review code before you run it.

latestvk97dqdm5vnazbjnz1myjw0yas980w6v3
1.4kdownloads
1stars
10versions
Updated 1mo ago
v2.0.3
MIT-0

Task Sync

Operate and troubleshoot bidirectional task sync between TickTick and Google Tasks.

Run

python {baseDir}/sync.py

Setup Checklist

  1. Python 3.10+ with: google-auth google-auth-oauthlib google-api-python-client requests
  2. Enable Google Tasks API and run:
    python {baseDir}/scripts/setup_google_tasks.py
    
  3. Create TickTick developer app and run:
    python {baseDir}/scripts/setup_ticktick.py
    
  4. Configure {baseDir}/config.json token and data paths.

Expected Behavior

  • Sync Google Task Lists <-> TickTick Projects by same name.
  • Sync task title, completion status, and notes/content bidirectionally.
  • Map TickTick priority to Google title prefix: [★] high, [!] medium.
  • Export TickTick smart lists (Today, Next 7 Days, All) to Google Tasks one-way.

Due-Date Rule (Calendar Duplicates)

  • Keep due dates only in the "All" smart list.
  • For other synced lists, forward date to TickTick then clear Google due date.
  • Treat this as the source-of-truth rule when debugging duplicate Calendar items.

Automation

# Cron: every 10 minutes
*/10 * * * * /path/to/python {baseDir}/sync.py >> /path/to/sync.log 2>&1

Use OpenClaw cron if available.

Troubleshooting Workflow

  1. Re-run both OAuth setup scripts if auth errors appear.
  2. Verify config.json paths point to existing token files.
  3. Run python {baseDir}/sync.py and inspect sync_log.json and sync_db.json.
  4. Check API wrappers:
    • {baseDir}/utils/google_api.py
    • {baseDir}/utils/ticktick_api.py

Comments

Loading comments...