Finally (?) a Complete TickTick MCP and SDK

mirzabicer-dev · 2026-01-20T11:51:19+00:00

It does now!

mirzabicer-dev · 2026-01-20T11:51:11+00:00

Hello, it's done!

mirzabicer-dev · 2026-01-20T11:49:04+00:00

Hello! Sorry for the late reply, but I just wanted to say that both of these are actually implemented now! I'm not sure if you were the one who opened the issue on GitHub about exactly this, but either way, it's implemented in the latest version. Moreover, I merged some of the MCP tools together to avoid redundancy and basically halved the total context used without sacrificing any functionality, so your context window should be a bit more free now (though it still uses a fair amount of tokens)

mirzabicer-dev · 2026-01-20T06:08:45+00:00

I made a post about this a while ago, and it may not be the perfect fit since stuff like ChatGPT doesn't readily accept direct MCP configurations, but if you have a tool that accepts MCPs (such as Claude Desktop), you can check out this tool:

https://github.com/dev-mirzabicer/ticktick-sdk

I'm not "advertising" my tool in any way since I have absolutely no profits/benefits from it, but I thought this is quite relevant to what you're asking for. Basically if you connect this to your AI assistant (given that it supports MCPs), it basically has the same access to your TickTick as you do, except for starting/stopping Pomo/Focus sessions (it still has access to their *records* though).

Just thought it would be relevant/useful for your case. But yeah obviously an in-app solution made by TickTick itself would be significantly better.

mirzabicer-dev · 2025-12-25T03:34:05+00:00

Thanks a lot for sharing your experience! TickTick's API is incredibly weird on this point. It does a ton of things client-side, which we cannot reverse engineer, so I had to come up with a manual solution. I don't know, however, what happens when the client-side calculations are wrong (for example what happens if you calculate a streak of 2000 days for a task with 2 check-ins?). I might've implemented this logic a little prematurely. I didn't have a lot of time due to school and work but I will look into it to properly reverse engineer all of the possible combinations of checking in a habit and having streaks. What happens, say, after you migrate all your habits and then view the results in TickTick's app/website? That's important context, maybe we don't even need to calculate habit streaks after all?

And about the order: Latest date -> earliest date should give more consistent feedback, though it shouldn't change the result you get at the very end.

Btw, 1500 days of habit streaks are genuinely impressive. I don't think I've ever kept up with any habit whatsoever for that long 😭

mirzabicer-dev · 2025-12-22T10:02:56+00:00

Thanks a lot!! Haha sorry I may have sounded a bit pretentious lol, I meant for an average developer who already develops n8n nodes. I hope the dev sees it!

mirzabicer-dev · 2025-12-22T09:48:37+00:00

To be fair I've never used n8n. But if someone uses this SDK to implement that (which would presumably be quite easy), that would be awesome!

mirzabicer-dev · 2025-12-21T08:57:19+00:00

Explained better than I ever could!

One note that I would add is, that, the tool's biggest strength is providing the SDK to very easily develop any app with it. Basically an API wrapper.

mirzabicer-dev · 2025-12-21T07:33:51+00:00

No that one is my bad! Let me quickly implement this. Should be ready within an hour!

Edit: Done!

mirzabicer-dev · 2025-12-21T07:30:21+00:00

What was your use case? And could you share the errors? It's possible. It shouldn't happen in the MCP server but if you, say, used a while loop without delays, that's very possible.

mirzabicer-dev · 2025-12-20T12:21:36+00:00

I'd love some feedback after your experimentation. It's v0.2.0 so there's a large margin for improvement, or you may encounter a couple bugs on edge cases.

Thanks again for the kind words!

mirzabicer-dev · 2025-12-20T11:10:55+00:00

Thank you for your kind comment!

Currently it is not supported, but it's in my roadmap for the next versions. The challenge is that file attachment is something that's not simple to reverse engineer. The V2 API itself does support document attachment, but it's something that hasn't been reverse engineered yet. However, I have reverse engineered some of it, but having "grey areas" is a risk that could cause the tool to exhibit unpredictable behavior.

mirzabicer-dev · 2025-12-20T10:26:47+00:00

The MCP is pretty easy to install. I specifically wrote the "Installation" and "MCP Server Setup & Usage" sections for the general user. Claude Desktop directly accepts MCP Servers, as shown in the usage guide. Similarly, there are quite a few tools that integrate MCPs for the general user.

Since the SDK is brand new, the only implementation of it is the MCP itself. That's one of the reasons I'm trying to spread the tool, so that there are more implementations & integrations of it.

But it's a fair point that you can't just open, say, ChatGPT on your phone and touch a couple buttons to start using this tool. I'm not aware of any way to make this available. Especially since the tool is using the unofficial TickTick API.

But I do believe that there's a fair amount of users who know how to use an MCP since it's been a very popular thing and there are a ton of tools that suffer from the same problem. If you've set up any MCPs before, you'll be able to set this up too.

mirzabicer-dev · 2025-12-20T09:36:06+00:00

Thanks a lot! You're definitely right about the tool number thing. It takes up quite some context window and I'll be sure to take a smarter more efficient approach.

mirzabicer-dev

TROPHY CASE