Frequently Asked Questions about the TickTick MCP Server

Q: What is an MCP Server? A: MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs. An MCP server acts as a bridge, allowing AI models to access and interact with external data sources and tools, such as TickTick.

Q: What is the UBOS Asset Marketplace? A: The UBOS Asset Marketplace is a platform that offers various tools and integrations to enhance AI Agent development. The TickTick MCP Server is one of the assets available on this marketplace.

Q: What is the TickTick MCP Server? A: The TickTick MCP Server is a tool that enhances your TickTick workflow by providing improved filtering capabilities and allowing AI assistants and MCP-compatible applications to interact with your tasks more effectively.

Q: What features does the TickTick MCP Server offer? A: The server provides comprehensive access to TickTick functionalities via MCP tools, including task management (create, update, delete, complete, move), subtask management, task retrieval (by ID, fields, date range, project, or filter criteria), and project/tag management.

Q: How do I get started with the TickTick MCP Server? A: To get started, you need to register a TickTick application, configure your environment variables with API credentials, and authenticate the server. Detailed instructions are provided in the documentation.

Q: What are the prerequisites for using the TickTick MCP Server? A: You need Python >= 3.10 and access to TickTick API credentials.

Q: How do I obtain TickTick API credentials? A: You need to register an application with TickTick to obtain API credentials. Follow the steps in the ticktick-py documentation to register your app and obtain a Client ID and Client Secret.

Q: What is the OAuth Redirect URL and how do I configure it? A: The OAuth Redirect URL is the URL where you want to be redirected after authorizing the application. It doesn’t need to be a live URL. Common choices for local development are http://localhost:8080/redirect or http://127.0.0.1:8080/. Ensure this exact URL is saved in your environment variables.

Q: How do I handle authentication on the first run? A: On the first run, the ticktick-py library will initiate an OAuth2 authentication flow. A web browser window might open automatically, or a URL will be printed in the console/log output. Visit this URL, log in to TickTick if necessary, and authorize the application.

Q: Where should I store my TickTick API credentials? A: The server looks for a .env file located at ~/.config/ticktick-mcp/.env by default. You can specify a different directory using the --dotenv-dir command-line argument when running the server directly via Python.

Q: How can I run the server? A: You can run the server either via an MCP client (recommended for AI assistant integration) or directly via Python. Example configuration is provided in the documentation.

Q: What MCP clients can I use with the TickTick MCP Server? A: You can use MCP clients like Claude Desktop, VS Code Agent Mode, or mcp-use.

Q: What are the available tools for interacting with the TickTick service? A: The server provides tools for Task Management (create, update, delete, complete, move), Task Retrieval (get by ID, get all, get tasks from project, filter tasks), and Helper Tools (datetime conversion).

Q: Can you provide an example of how to use the server with an AI agent? A: Yes, a sample agent prompt is provided in the documentation, demonstrating how to integrate with the user’s TickTick account to assist in daily work planning.

Q: How can I contribute to the project? A: Contributions are welcome! Please feel free to open an issue or submit a pull request.

Q: What license is this project under? A: This project is licensed under the MIT License.

Q: Where can I find more information about MCP? A: You can find more information at Model Context Protocol Servers and modelcontextprotocol.io.

Q: How does the TickTick MCP server integrate with the UBOS platform? A: The TickTick MCP server integrates seamlessly with the UBOS platform, allowing you to connect to other services, build custom AI Agents, automate workflows, and enhance productivity.