ticktick-mcp-server

tsutsuhiro/ticktick-mcp-server

3.3

If you are the rightful owner of ticktick-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

TickTick MCP Server enables integration with TickTick task management platform using OAuth 2.1 with PKCE for secure authentication.

The TickTick MCP (Model Context Protocol) Server is designed to facilitate seamless integration with the TickTick task management platform from Claude Desktop. It leverages OAuth 2.1 with PKCE (Proof Key for Code Exchange) to ensure secure authentication and authorization processes. This server provides a comprehensive suite of task and project management capabilities, allowing users to create, update, delete, and manage tasks and projects efficiently. The server also includes automatic token refresh functionality to maintain continuous access without user intervention. Developers can configure authentication credentials using various methods, including JSON files, environment variables, or system environment variables, ensuring flexibility and ease of setup. The server supports a wide range of operations, including task search and filtering, project archiving, and enhanced error handling, making it a robust solution for managing tasks and projects within the TickTick ecosystem.

Features

  • Secure authentication using OAuth 2.1 with PKCE
  • Comprehensive task and project management capabilities
  • Automatic token refresh for continuous access
  • Flexible configuration options for authentication credentials
  • Enhanced error handling and troubleshooting

Usages

usage with claude desktop

{
  "mcpServers": {
    "ticktick": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/ticktick-mcp-server/dist/index.js"],
      "env": {
        "TICKTICK_CLIENT_ID": "your_client_id",
        "TICKTICK_CLIENT_SECRET": "your_client_secret",
        "TICKTICK_REDIRECT_URI": "http://localhost:8080/callback",
        "TICKTICK_CREDENTIALS_PATH": "/absolute/path/to/.ticktick-mcp-server-credentials.json",
        "LOG_LEVEL": "info"
      }
    }
  }
}

Tools

  1. ticktick_auth_status

    Check authentication status

  2. ticktick_authorize

    Start OAuth authentication flow

  3. ticktick_logout

    Clear saved tokens

  4. ticktick_health_check

    Test API connectivity

  5. ticktick_list_tasks

    Get task list with filtering and sorting

  6. ticktick_get_task

    Get specific task details

  7. ticktick_create_task

    Create new task

  8. ticktick_update_task

    Update task details

  9. ticktick_delete_task

    Delete task

  10. ticktick_complete_task

    Mark task as completed

  11. ticktick_uncomplete_task

    Mark task as incomplete

  12. ticktick_search_tasks

    Search tasks

  13. ticktick_get_overdue_tasks

    Get overdue tasks

  14. ticktick_list_projects

    Get project list

  15. ticktick_get_project

    Get specific project details

  16. ticktick_create_project

    Create new project

  17. ticktick_update_project

    Update project

  18. ticktick_delete_project

    Delete project

  19. ticktick_get_project_tasks

    Get tasks in a project

  20. ticktick_get_project_stats

    Get project statistics

  21. ticktick_archive_project

    Archive project

  22. ticktick_unarchive_project

    Unarchive project