UBOS Asset Marketplace: TickTick MCP Server - Intelligent Task Management for the AI-Powered Enterprise

In the modern, fast-paced business environment, efficient task management is not merely a desirable attribute but a fundamental necessity. Businesses are constantly seeking innovative ways to optimize workflows, boost productivity, and harness the power of artificial intelligence to gain a competitive edge. UBOS is at the forefront of this revolution, providing a full-stack AI Agent Development Platform designed to empower businesses across various departments. The UBOS Asset Marketplace is proud to feature the TickTick MCP Server, a tool designed to seamlessly integrate task management with intelligent, context-aware operations.

What is the TickTick MCP Server?

The TickTick MCP (Model Context Protocol) Server is a cutting-edge solution designed to bridge the gap between the TickTick task management platform and the world of AI. By leveraging the Model Context Protocol (MCP), this server enables AI models to access and interact with task-related data within TickTick. This integration facilitates intelligent automation, context-aware task operations, and enhanced productivity.

At its core, the TickTick MCP Server allows you to manage tasks, organize projects, track habits, and more—all within the TickTick environment. It provides a comprehensive suite of features accessible via API, making it easier than ever to incorporate task management into your AI-driven workflows.

Key Features and Capabilities

The TickTick MCP Server is packed with features designed to streamline task management and enhance productivity. Here’s a detailed look at its core capabilities:

1. Task Management

The server supports comprehensive task management functionalities, including:

• Create: Instantly create new tasks with customizable properties.
• Read: Retrieve detailed information about existing tasks.
• Update: Modify task attributes to reflect changing priorities and deadlines.
• Delete: Remove tasks that are no longer relevant.

Each task can be configured with various properties such as title, content, description, due dates, reminders, and priority levels, providing a granular level of control over your task management process.

2. Project Management

Beyond individual tasks, the TickTick MCP Server facilitates robust project management:

• Create: Establish new projects to organize related tasks.
• Read: Access project details and overviews.
• Update: Adjust project settings and parameters.
• Delete: Archive or remove projects as needed.

With customizable views and organizational structures, project management becomes more intuitive and efficient.

3. Subtask Support

The ability to manage subtasks is crucial for breaking down complex projects into manageable steps. The TickTick MCP Server offers full support for subtasks, allowing you to:

• Create subtasks within parent tasks.
• Manage subtask properties such as titles, dates, and completion status.
• Organize subtasks to align with project goals.

4. Complete Task Control

Achieve complete control over your tasks with features like:

• Priority Settings: Assign priority levels (None, Low, Medium, High) to tasks.
• Due Dates: Set specific deadlines to ensure timely completion.
• Reminders: Configure reminders to stay on track.
• Recurring Rules: Establish recurring tasks for regular activities.

These features ensure that you never miss a deadline and can efficiently manage your workload.

5. OAuth Authentication

Security is paramount, and the TickTick MCP Server implements full OAuth2 authentication for secure API access. This ensures that your task data remains protected and accessible only to authorized users and applications.

6. Comprehensive Error Handling

Clear and informative error messages are crucial for troubleshooting and maintaining smooth operations. The server provides comprehensive error handling, offering clear messages for common issues to help you quickly resolve any problems.

Tools Available

The TickTick MCP Server includes a variety of tools, each designed to perform specific functions. Here’s a detailed breakdown:

1. get_task_by_ids

   • Function: Retrieves a specific task by project ID and task ID.
   • Inputs: projectId (string), taskId (string).
   • Returns: Task object matching TickTickTaskSchema.

2. create_task

   • Function: Creates a new task in a specified project.
   • Inputs: title (string), projectId (string), and optional fields like content, desc, isAllDay, startDate, dueDate, timeZone, reminders, repeatFlag, priority, sortOrder, and items (subtasks).
   • Returns: Created task object matching TickTickTaskSchema.

3. update_task

   • Function: Updates an existing task.
   • Inputs: taskId (string, Path), id (string, Body), projectId (string), and all optional fields from create_task.
   • Returns: Updated task object matching TickTickTaskSchema.

4. complete_task

   • Function: Marks a task as completed.
   • Inputs: taskId (string), projectId (string).
   • Returns: Void.

5. delete_task

   • Function: Deletes a task from a project.
   • Inputs: taskId (string), projectId (string).
   • Returns: Void.

6. get_user_projects

   • Function: Retrieves all projects for the authenticated user.
   • Inputs: None.
   • Returns: Array of project objects matching TickTickProjectSchema.

7. get_project_by_id

   • Function: Retrieves a specific project by ID.
   • Inputs: projectId (string).
   • Returns: Project object matching TickTickProjectSchema.

8. get_project_with_data

   • Function: Retrieves project details along with tasks and columns.
   • Inputs: projectId (string).
   • Returns: Object containing project (matching TickTickProjectSchema), tasks (array of TickTickTaskSchema objects), and optional columns.

9. create_project

   • Function: Creates a new project.
   • Inputs: name (string), and optional fields like color, viewMode, and kind.
   • Returns: Created project object matching TickTickProjectSchema.

10. update_project

    • Function: Updates an existing project.
    • Inputs: projectId (string), and optional fields like name, color, sortOrder, viewMode, and kind.
    • Returns: Updated project object matching TickTickProjectSchema.

11. delete_project

    • Function: Deletes a project.
    • Inputs: projectId (string).
    • Returns: Void.

Integrating with the UBOS Platform

UBOS provides a comprehensive platform for developing, orchestrating, and deploying AI Agents. Integrating the TickTick MCP Server with UBOS unlocks a new realm of possibilities for task management and automation.

• AI-Driven Task Automation: By connecting the TickTick MCP Server to UBOS, you can create AI Agents that automatically manage tasks based on predefined rules and triggers. For example, an agent could automatically create a task when a new lead is generated in your CRM system.
• Context-Aware Workflows: Leverage the MCP to provide AI Agents with context about ongoing tasks, projects, and deadlines. This enables agents to make more informed decisions and execute tasks more effectively.
• Custom AI Agent Development: Use the UBOS platform to build custom AI Agents that interact with the TickTick MCP Server. Tailor these agents to meet specific business needs, such as automated reporting, deadline reminders, and task prioritization.
• Multi-Agent Systems: Orchestrate multiple AI Agents to work together on complex projects. For example, one agent could manage task creation, while another monitors progress and sends notifications.

Use Cases

The TickTick MCP Server can be applied in various scenarios to enhance productivity and streamline workflows:

• Automated Task Creation: Automatically create tasks based on triggers from other applications, such as email, calendar events, or CRM updates.
• Intelligent Task Prioritization: Use AI to prioritize tasks based on urgency, importance, and dependencies.
• Deadline Management: Set up AI Agents to monitor deadlines and send timely reminders to ensure tasks are completed on time.
• Project Monitoring: Track project progress and generate reports automatically, providing insights into team performance and potential bottlenecks.
• Personalized Task Management: Customize task management workflows based on individual user preferences and roles.

Setting Up the TickTick MCP Server

Setting up the TickTick MCP Server involves a few key steps:

1. OAuth Authentication: Register your application with TickTick and obtain API credentials.
2. First-Time Authorization: Authorize the application and generate an access token.
3. Configuration: Configure your environment with the necessary credentials (Client ID, Client Secret, Access Token).

OAuth Authentication Setup

1. Create an account on the TickTick Developer Portal.
2. Register a new application.
3. Set the OAuth redirect URL to http://localhost:8000/callback.
4. Copy the generated Client ID (TICKTICK_CLIENT_ID) and Client Secret (TICKTICK_CLIENT_SECRET).

First-Time Authorization Flow

1. Configure your credentials using either a .env file or terminal environment variables.
2. Run the authentication command:
   • If using the published package: npx @alexarevalo.ia/mcp-server-ticktick ticktick-auth
   • If running the MCP server locally: npm run start:auth
3. Save the generated access token.

Integrating with Claude Desktop

The TickTick MCP Server can be integrated with Claude Desktop using either NPX or Docker.

NPX

{ “mcpServers”: { “ticktick”: { “command”: “npx”, “args”: [“-y”, “@alexarevalo.ai/mcp-server-ticktick”], “env”: { “TICKTICK_CLIENT_ID”: “<YOUR_CLIENT_ID>”, “TICKTICK_CLIENT_SECRET”: “<YOUR_CLIENT_SECRET>”, “TICKTICK_ACCESS_TOKEN”: “<YOUR_ACCESS_TOKEN>” } } } }

Docker

{ “mcpServers”: { “ticktick”: { “command”: “docker”, “args”: [ “run”, “-i”, “–rm”, “-e”, “TICKTICK_CLIENT_ID”, “-e”, “TICKTICK_CLIENT_SECRET”, “-e”, “TICKTICK_ACCESS_TOKEN”, “mcp/ticktick” ], “env”: { “TICKTICK_CLIENT_ID”: “<YOUR_CLIENT_ID>”, “TICKTICK_CLIENT_SECRET”: “<YOUR_CLIENT_SECRET>”, “TICKTICK_ACCESS_TOKEN”: “<YOUR_ACCESS_TOKEN>” } } } }

Installing via Smithery

For automated installation via Smithery:

bash npx -y @smithery/cli install @alexarevalo9/ticktick-mcp-server --client claude

Why Choose the TickTick MCP Server on UBOS?

Choosing the TickTick MCP Server on the UBOS platform provides numerous advantages:

• Seamless Integration: Easily integrate task management into your AI-driven workflows.
• Enhanced Productivity: Automate tasks and streamline processes to boost productivity.
• Customization: Tailor AI Agents to meet specific business requirements.
• Security: Ensure secure access to task data with OAuth authentication.
• Comprehensive Support: Benefit from detailed documentation and community support.

Conclusion

The TickTick MCP Server on the UBOS Asset Marketplace represents a significant advancement in task management and AI integration. By leveraging the power of the Model Context Protocol, this server enables businesses to automate tasks, streamline workflows, and enhance productivity. Whether you’re looking to automate task creation, prioritize deadlines, or monitor project progress, the TickTick MCP Server provides the tools and capabilities you need to succeed. Integrate it with the UBOS platform to unlock the full potential of AI-driven task management and propel your business forward.