Skip to main content
Glama
MostafaSuliman

TickTick MCP Server

by MostafaSuliman
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
ticktick_configure_oauthA
    Configure OAuth2 credentials for TickTick API v1.

    This is the first step for OAuth authentication. After configuration,
    you'll receive an authorization URL to visit.

    Args:
        params: OAuth credentials

    Returns:
        Authorization URL and instructions
ticktick_authorize_oauthA
    Complete OAuth2 authorization with the code from callback URL.

    Use this after visiting the authorization URL and being redirected.

    Args:
        params: Authorization code

    Returns:
        Success message with token details
ticktick_loginA
    Login with username/password for v2 API access.

    This enables extended features like tags, habits, and focus timer.

    Args:
        params: Login credentials

    Returns:
        Success message
ticktick_auth_statusA
    Check current authentication status.

    Returns:
        Authentication status details
ticktick_logoutA
    Clear all authentication tokens (logout).

    Returns:
        Confirmation message
ticktick_list_tasksB

List tasks with optional filtering.

Supports filtering by project, priority, tags, and search query.

ticktick_get_taskA

Get a specific task by ID.

Requires both task ID and project ID.

ticktick_create_taskB
    Create a new task in TickTick.

    Can set title, description, due date, priority, tags, and more.
    If project_id is not provided, task goes to inbox.
ticktick_update_taskB

Update an existing task.

Only provided fields will be updated.

ticktick_complete_taskB

Mark a task as complete.

ticktick_uncomplete_taskB

Reopen a completed task (mark as incomplete).

ticktick_delete_taskA
    Delete a task permanently.

    Warning: This action cannot be undone.
ticktick_move_taskB

Move a task to a different project/list.

ticktick_create_subtaskB
    Create a subtask under a parent task.

    Note: Requires v2 API for full hierarchy support.
ticktick_get_completed_tasksA

Get completed tasks within a date range.

Requires v2 API authentication (username/password login).

ticktick_batch_create_tasksA

Create multiple tasks in a single request.

More efficient than creating tasks one by one.

ticktick_batch_delete_tasksB
    Delete multiple tasks in a single request.

    Warning: This action cannot be undone.
ticktick_list_projectsA

List all projects/lists.

Returns project details including ID, name, color, and task count.

ticktick_get_projectB

Get details of a specific project including its tasks.

ticktick_create_projectB

Create a new project/list.

Projects can be organized in folders and have different view modes.

ticktick_update_projectB

Update an existing project's properties.

ticktick_delete_projectA
    Delete a project and all its tasks.

    Warning: This action cannot be undone. All tasks in the project will be deleted.
ticktick_archive_projectA

Archive a project.

Archived projects are hidden from the main view but can be restored. Requires v2 API authentication.

ticktick_list_foldersA

List all project folders.

Folders are used to organize projects.

ticktick_create_folderB

Create a new project folder.

Folders help organize projects into logical groups.

ticktick_update_folderB

Rename a project folder.

ticktick_delete_folderA

Delete a project folder.

Projects in the folder will be moved to the root level.

ticktick_list_tagsA

List all tags in your TickTick account.

Requires v2 API authentication (username/password login). Tags can be nested (have parent-child relationships).

ticktick_create_tagA

Create a new tag.

Tags can be nested by specifying a parent tag name. Requires v2 API authentication.

ticktick_update_tagA

Update a tag's properties (color, etc.).

Requires v2 API authentication.

ticktick_rename_tagA

Rename a tag.

All tasks with the old tag will be updated to use the new name. Requires v2 API authentication.

ticktick_merge_tagsA

Merge one tag into another.

The source tag will be deleted, and all tasks will be moved to the target tag. Requires v2 API authentication.

ticktick_delete_tagA

Delete a tag.

The tag will be removed from all tasks. Requires v2 API authentication.

ticktick_get_tag_tasksB

Get all tasks that have a specific tag.

Requires v2 API authentication.

ticktick_list_habitsA

List all habits.

Requires v2 API authentication (username/password login).

ticktick_get_habitB

Get details of a specific habit including its statistics.

Requires v2 API authentication.

ticktick_create_habitA

Create a new habit to track.

Set daily goals, reminders, and custom icons/colors. Requires v2 API authentication.

ticktick_update_habitB

Update an existing habit's properties.

Requires v2 API authentication.

ticktick_delete_habitA
    Delete a habit.

    Warning: This will delete all check-in history for this habit.
    Requires v2 API authentication.
ticktick_checkin_habitA

Record a habit check-in.

Track your daily progress toward habit goals. Requires v2 API authentication.

ticktick_get_habit_statsA

Get statistics for a specific habit.

Includes completion rate, streaks, and historical data. Requires v2 API authentication.

ticktick_get_today_habitsA

Get today's status for all habits.

Shows which habits are completed and which need attention. Requires v2 API authentication.

ticktick_start_pomodoroA

Start a Pomodoro focus session.

The classic Pomodoro technique with customizable duration. Can be linked to a specific task. Requires v2 API authentication.

ticktick_start_stopwatchB

Start a stopwatch focus session.

Open-ended focus tracking without a fixed duration. Requires v2 API authentication.

ticktick_stop_focusA

Stop the current focus session.

Optionally save or discard the focus record. Requires v2 API authentication.

ticktick_get_focus_recordsA

Get focus session history.

Filter by date range and focus type (pomodoro/stopwatch). Requires v2 API authentication.

ticktick_get_today_focusA

Get today's focus time statistics.

Shows total focus time, pomodoro count, and progress toward daily goal. Requires v2 API authentication.

ticktick_get_focus_settingsA

Get current Pomodoro/focus settings.

Shows work duration, break times, and daily goals. Requires v2 API authentication.

ticktick_update_focus_settingsA

Update Pomodoro/focus settings.

Customize work duration, breaks, and automation preferences. Requires v2 API authentication.

ticktick_delete_focus_recordA
    Delete a focus record.

    Warning: This cannot be undone.
    Requires v2 API authentication.
ticktick_get_overviewA

Get today's productivity overview.

Includes task status, habit progress, and focus statistics. Extended features require v2 API authentication.

ticktick_get_daily_summaryA

Get detailed summary for a specific day.

Shows tasks completed, habits done, and focus time. Requires v2 API for complete data.

ticktick_get_weekly_reportA

Get weekly productivity report.

Includes daily breakdown, totals, and trends. Requires v2 API for complete data.

ticktick_get_productivity_scoreA

Calculate your productivity score.

Score is based on task completion, habit consistency, and focus time. Includes personalized recommendations. Extended metrics require v2 API authentication.

ticktick_get_task_analyticsA

Get detailed task analytics.

Shows priority distribution, due date analysis, and tag usage.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/MostafaSuliman/TickTick-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server