🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Ticktick Cli

by @norickkevorkov

Manage TickTick tasks and projects from the command line with OAuth2 auth, batch operations, and rate limit handling.

Versionv1.0.0
βš™οΈ Configuration

Tokens are stored in ~/.clawdbot/credentials/ticktick-cli/config.json:

{
  "clientId": "YOUR_CLIENT_ID",
  "clientSecret": "YOUR_CLIENT_SECRET",
  "accessToken": "...",
  "refreshToken": "...",
  "tokenExpiry": 1234567890000,
  "redirectUri": "http://localhost:8080"
}

Note: Credentials are stored in plaintext. The CLI attempts to set file permissions to 700/600; treat this file as sensitive.

The CLI automatically refreshes tokens when they expire.

πŸ“‹ Tips & Best Practices

"Not authenticated" error

Run bun run scripts/ticktick.ts auth to authenticate.

"Project not found" error

Use bun run scripts/ticktick.ts lists to see available projects and their IDs.

"Task not found" error

  • Check the task title matches exactly (case-insensitive)
  • Try using the task ID instead
  • Use --list to narrow the search to a specific project
  • Token expired errors

    The CLI should auto-refresh tokens. If issues persist, run bun run scripts/ticktick.ts auth again.

    View on ClawHub
    TERMINAL
    clawhub install ticktick-cli

    πŸ§ͺ Use this skill with your agent

    Most visitors already have an agent. Pick your environment, install or copy the workflow, then run the smoke-test prompt above.

    πŸ” Can't find the right skill?

    Search 60,000+ AI agent skills β€” free, no login needed.

    Search Skills β†’