2026-10-16

TickTick connector for Claude: is there a TickTick MCP server?

Short answer: yes. TickTick's own help center documents a TickTick MCP server and describes how to connect it to Claude and several other AI assistants. This page summarizes what that documentation says, explains in plain terms how a task manager connects to Claude over MCP, and then covers how GetItDone's own MCP server works. Everything said about TickTick comes from its help center and is dated in the sources section.

What MCP is

MCP, the Model Context Protocol, is described on its official site as an open-source standard for connecting AI applications to external systems. An assistant such as Claude acts as the client, and a service such as a task manager acts as the server. Once connected, the assistant can call the tools the server offers, so "what is due today?" or "add a task" runs against your real task list instead of a pasted copy of it.

What TickTick says about its MCP server and the Claude connector

TickTick's help article "TickTick MCP" says that by connecting to its MCP, your AI assistant can read, create and manage your tasks directly. The server address it gives is https://mcp.ticktick.com. It says the server supports the Streamable HTTP transport, and that authentication works by OAuth sign-in or by a Bearer token you create in the TickTick web app under Settings, Account & Security, API Token.

For Claude, the article lists a connector: open the connectors settings in Claude, search for TickTick (or use the TickTick connectors page the article links to), choose Connect, and complete the OAuth sign-in and authorization. The same article has separate setup steps for ChatGPT, Gemini, Grok, Perplexity, Claude Code, Cursor, VS Code, Codex CLI, TRAE and Antigravity. For Claude Code it gives a one-line command that adds https://mcp.ticktick.com as an HTTP server.

The article groups the tools it provides into task queries, list management, task management, habits, focus records and countdowns. It gives no total number of tools.

Limits TickTick documents

The article's FAQ states two limits. First, TickTick MCP supports only the Streamable HTTP protocol and not SSE, so a client that supports only SSE cannot connect directly for now. Second, it says TickTick MCP mainly supports basic task, list, habit, focus record and countdown operations, and that other advanced features are not supported yet. It also says OAuth authorization refreshes tokens automatically, so you normally do not need to sign in again each time you restart the AI client.

We found no statement in the article about which Claude plans can use the TickTick connector, so this page does not make one. Anthropic's documentation on custom connectors lists the plans that can add a remote MCP server, and it is linked in the sources below.

What about a TickTick MCP server from someone other than TickTick?

Searching for "TickTick MCP server" also turns up community projects that wrap TickTick's developer API. We do not describe them here, because we have not reviewed their code, and their own repositories, not this page, are the place to judge them. Anthropic's documentation says custom connectors can connect Claude to services that have not been verified by Anthropic, and advises connecting only servers from organizations you trust.

How a task manager connects to Claude over MCP

The mechanics are the same for any task manager that publishes a remote MCP server. According to Anthropic's support documentation, you open Customize and then Connectors in Claude, choose Add, then Add custom connector, enter a name and the server URL, and set how you sign in. If the service has a listing in Claude's connector directory, you can connect from the listing instead of typing a URL. Custom connectors are available on the Free, Pro, Max, Team and Enterprise plans, with Free limited to one custom connector. On Team and Enterprise, an owner adds the connector for the organization first.

A server that uses OAuth opens a sign-in window, and you approve what the assistant may do. A server that uses a fixed key or token takes it as a request header instead. After that, the assistant lists the server's tools and calls them when your message calls for it.

How GetItDone's MCP server works

GetItDone runs a hosted MCP server at https://app.nowgetitdone.com/api/mcp. It uses the Streamable HTTP transport and OAuth 2.1 sign-in with PKCE: a client registers itself, your browser opens GetItDone, and a consent screen lists exactly what the assistant is asking for, such as reading or writing tasks, and which workspaces it may use. Nothing is installed locally. If your client cannot sign in, you can instead create a gid_ API key under Settings, API Keys and send it as a Bearer header.

The server registers 15 tools, each with a required scope; a tool your connection was not granted is never shown to the assistant. It uses Code Mode, so the assistant first lists the tools it can reach and then runs a short program that calls them. Connected apps appear under Connected Apps in your GetItDone profile, and revoking one takes effect on its next request.

In Claude, you add GetItDone as a custom connector with the URL above. In Claude Code, one command adds it, and /mcp finishes the sign-in. Setup for ChatGPT, Cursor, VS Code, Gemini and other clients is in the MCP guide linked below.

If your tasks carry screenshots or screen recordings, the server returns attachment contents and a summary of frames extracted from videos, not only titles and statuses. The post on why your assistant should see the screenshot explains how.

Sources

TickTick, Anthropic and Model Context Protocol pages read on 2026-10-16. This page restates them in our own words and may fall behind; the pages below are the authority.