TickTick MCP Server

Instructions

Implementation Reference

• src/index.ts:259-268 (handler)

  Handler for the 'get_projects' tool in the MCP server request handler. It calls the TickTickClient's getProjects method and returns the projects as a JSON string in the response content.

  case 'get_projects':
    const projects = await this.ticktickClient!.getProjects();
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(projects, null, 2),
        },
      ],
    };

• src/types.ts:47-73 (schema)

  Zod schema definition for TickTickProject, used as the type for projects returned by getProjects.

  export const TickTickProjectSchema = z.object({
    id: z.string(),
    name: z.string(),
    color: z.string().optional(),
    inAll: z.boolean().optional(),
    sortOrder: z.number().optional(),
    sortType: z.string().optional(),
    userCount: z.number().optional(),
    etag: z.string().optional(),
    modifiedTime: z.string().optional(),
    closed: z.boolean().optional(),
    muted: z.boolean().optional(),
    transferred: z.boolean().optional(),
    groupId: z.string().optional(),
    viewMode: z.string().optional(),
    notificationOptions: z.object({
      beMentioned: z.boolean().optional(),
      newTaskAssignedToMe: z.boolean().optional(),
      newTaskCreated: z.boolean().optional(),
      taskCompleted: z.boolean().optional(),
      taskDeleted: z.boolean().optional(),
      taskUpdated: z.boolean().optional()
    }).optional(),
    teamId: z.string().optional(),
    permission: z.string().optional(),
    kind: z.string().optional()
  });

• src/index.ts:82-89 (registration)

  Registration of the 'get_projects' tool in the MCP tools list, including name, description, and empty input schema.

  {
    name: 'get_projects',
    description: 'Get all projects from TickTick',
    inputSchema: {
      type: 'object',
      properties: {},
    },
  },

• src/ticktick-client.ts:288-297 (helper)

  Core implementation of getProjects in TickTickClient class, which authenticates and makes an API GET request to '/project' to fetch the list of projects.

  async getProjects(): Promise<TickTickProject[]> {
    await this.ensureAuthenticated();
    
    try {
      const response = await this.client.get('/project');
      return response.data || [];
    } catch (error) {
      throw new Error(`Failed to get projects: ${error instanceof Error ? error.message : 'Unknown error'}`);
    }
  }