# TickTick MCP v2
A Model Context Protocol (MCP) server for TickTick that enables interacting with your TickTick task management system directly through Claude and other MCP clients using v2 interfaces.
## Project Purpose
1. **Easy Authentication**: Direct username/password authentication.
2. **Rich API Functionality**: The v2 interfaces easy to implement more complex features. For example, other v1 TickTick interface cannot even retrieve tasks from the Inbox.
## Features
- 📋 View all your TickTick projects and tasks
- ✏️ Create new projects and tasks through natural language
- 🔄 Update existing task details (title, content, dates, priority)
- ✅ Mark tasks as complete
- 🗑️ Delete tasks and projects
- 🔐 Username/password authentication with local credential storage
## Quick Start
Create a `mcp.json` file:
```json
{
"mcpServers": {
"ticktick-mcp-v2": {
"command": "uvx",
"args": ["--from", "ticktick-mcp-v2", "ticktick-mcp", "run"],
"env": {
"TICKTICK_USERNAME": "your_username",
"TICKTICK_PASSWORD": "your_password"
}
}
}
}
```
### Start Using
You can now interact with your TickTick tasks directly! Try asking:
- "Show me all my TickTick projects"
- "Create a task called 'Finish documentation' with high priority"
- "What tasks do I have due today?"
## Development Setup
1. **Install and authenticate:**
```bash
uvx --from ticktick-mcp-v2 ticktick-mcp auth
```
2. **Test the connection:**
```bash
uvx --from ticktick-mcp-v2 ticktick-mcp test
```
3. **Run the server:**
```bash
uvx --from ticktick-mcp-v2 ticktick-mcp run
```
## Usage Examples
### Using with other MCP clients
Any MCP-compatible client can connect using the configuration above.
## Available MCP Tools
| Tool | Description | Parameters |
|------|-------------|------------|
| **Authentication** |
| `auth_status` | Check authentication status | None |
| **Project Management** |
| `get_projects` | List all projects | None |
| `get_project` | Get project details | `project_id` |
| `create_project` | Create new project | `name`, `color` (optional), `view_mode` (optional) |
| `delete_project` | Delete project | `project_id` |
| `get_project_tasks` | Get tasks in project | `project_id`, `include_completed` (optional) |
| **Task Management** |
| `get_tasks` | List all tasks | `include_completed` (optional) |
| `create_task` | Create new task | `title`, `project_id` (optional), `content` (optional), `start_date` (optional), `due_date` (optional), `priority` (optional) |
| `update_task` | Update task | `task_id`, `project_id` (optional), `title` (optional), `content` (optional), `start_date` (optional), `due_date` (optional), `priority` (optional) |
| `delete_task` | Delete task | `project_id`, `task_id` |
| `complete_task` | Mark task complete | `task_id` |
| **Advanced Features** |
| `search_tasks` | Search tasks | `query` |
| `get_tasks_by_priority` | Get tasks by priority | `priority` (0=None, 1=Low, 3=Medium, 5=High) |
| `get_tasks_due_today` | Get tasks due today | None |
| `get_overdue_tasks` | Get overdue tasks | None |
## Example Prompts
- "Show me all my TickTick projects"
- "Create a task called 'Finish documentation' with high priority"
- "What tasks do I have due today?"
- "Mark the task 'Buy groceries' as complete"
- "Update task 'Meeting notes' with new due date tomorrow"
## Acknowledgments
This project would not be possible without the excellent work of the following open source projects:
### 🎯 [ticktick-py](https://github.com/lazeroffmichael/ticktick-py)
**Original Author**: [Michael Lazeroff](https://github.com/lazeroffmichael)
**Fork Maintainer**: [yidianyiko](https://github.com/yidianyiko)
The core TickTick Python SDK that powers this MCP server. This unofficial API library provides comprehensive access to TickTick's functionality, enabling seamless integration with the TickTick task management platform.
### 🤝 Contributing
If you find this project useful, please consider:
- 🐛 Reporting issues or suggesting improvements
- 📖 Contributing
## License
MIT License - see LICENSE file for details.
Raw data
{
"_id": null,
"home_page": null,
"name": "ticktick-mcp-v2",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "ticktick, mcp, model-context-protocol, task-management",
"author": null,
"author_email": "TickTick MCP Team <dev@example.com>",
"download_url": "https://files.pythonhosted.org/packages/bd/bd/e72e65dc52b4c81a847e7d02ba62cbbe1e69de500de40faa6f716be63728/ticktick_mcp_v2-1.0.4.tar.gz",
"platform": null,
"description": "# TickTick MCP v2\n\nA Model Context Protocol (MCP) server for TickTick that enables interacting with your TickTick task management system directly through Claude and other MCP clients using v2 interfaces.\n\n## Project Purpose\n\n1. **Easy Authentication**: Direct username/password authentication.\n\n2. **Rich API Functionality**: The v2 interfaces easy to implement more complex features. For example, other v1 TickTick interface cannot even retrieve tasks from the Inbox.\n\n## Features\n\n- \ud83d\udccb View all your TickTick projects and tasks\n- \u270f\ufe0f Create new projects and tasks through natural language\n- \ud83d\udd04 Update existing task details (title, content, dates, priority)\n- \u2705 Mark tasks as complete\n- \ud83d\uddd1\ufe0f Delete tasks and projects\n- \ud83d\udd10 Username/password authentication with local credential storage\n\n## Quick Start\n\nCreate a `mcp.json` file:\n\n```json\n{\n \"mcpServers\": {\n \"ticktick-mcp-v2\": {\n \"command\": \"uvx\",\n \"args\": [\"--from\", \"ticktick-mcp-v2\", \"ticktick-mcp\", \"run\"],\n \"env\": {\n \"TICKTICK_USERNAME\": \"your_username\",\n \"TICKTICK_PASSWORD\": \"your_password\"\n }\n }\n }\n}\n```\n\n### Start Using\n\nYou can now interact with your TickTick tasks directly! Try asking:\n- \"Show me all my TickTick projects\"\n- \"Create a task called 'Finish documentation' with high priority\"\n- \"What tasks do I have due today?\"\n\n## Development Setup\n\n1. **Install and authenticate:**\n ```bash\n uvx --from ticktick-mcp-v2 ticktick-mcp auth\n ```\n\n2. **Test the connection:**\n ```bash\n uvx --from ticktick-mcp-v2 ticktick-mcp test\n ```\n\n3. **Run the server:**\n ```bash\n uvx --from ticktick-mcp-v2 ticktick-mcp run\n ```\n\n## Usage Examples\n\n### Using with other MCP clients\nAny MCP-compatible client can connect using the configuration above.\n\n## Available MCP Tools\n\n| Tool | Description | Parameters |\n|------|-------------|------------|\n| **Authentication** |\n| `auth_status` | Check authentication status | None |\n| **Project Management** |\n| `get_projects` | List all projects | None |\n| `get_project` | Get project details | `project_id` |\n| `create_project` | Create new project | `name`, `color` (optional), `view_mode` (optional) |\n| `delete_project` | Delete project | `project_id` |\n| `get_project_tasks` | Get tasks in project | `project_id`, `include_completed` (optional) |\n| **Task Management** |\n| `get_tasks` | List all tasks | `include_completed` (optional) |\n| `create_task` | Create new task | `title`, `project_id` (optional), `content` (optional), `start_date` (optional), `due_date` (optional), `priority` (optional) |\n| `update_task` | Update task | `task_id`, `project_id` (optional), `title` (optional), `content` (optional), `start_date` (optional), `due_date` (optional), `priority` (optional) |\n| `delete_task` | Delete task | `project_id`, `task_id` |\n| `complete_task` | Mark task complete | `task_id` |\n| **Advanced Features** |\n| `search_tasks` | Search tasks | `query` |\n| `get_tasks_by_priority` | Get tasks by priority | `priority` (0=None, 1=Low, 3=Medium, 5=High) |\n| `get_tasks_due_today` | Get tasks due today | None |\n| `get_overdue_tasks` | Get overdue tasks | None |\n\n## Example Prompts\n\n- \"Show me all my TickTick projects\"\n- \"Create a task called 'Finish documentation' with high priority\"\n- \"What tasks do I have due today?\"\n- \"Mark the task 'Buy groceries' as complete\"\n- \"Update task 'Meeting notes' with new due date tomorrow\"\n\n## Acknowledgments\n\nThis project would not be possible without the excellent work of the following open source projects:\n\n### \ud83c\udfaf [ticktick-py](https://github.com/lazeroffmichael/ticktick-py)\n**Original Author**: [Michael Lazeroff](https://github.com/lazeroffmichael) \n**Fork Maintainer**: [yidianyiko](https://github.com/yidianyiko)\n\nThe core TickTick Python SDK that powers this MCP server. This unofficial API library provides comprehensive access to TickTick's functionality, enabling seamless integration with the TickTick task management platform.\n\n### \ud83e\udd1d Contributing\n\nIf you find this project useful, please consider:\n- \ud83d\udc1b Reporting issues or suggesting improvements\n- \ud83d\udcd6 Contributing \n\n## License\n\nMIT License - see LICENSE file for details. \n",
"bugtrack_url": null,
"license": "MIT",
"summary": "TickTick MCP Server - Enhanced Version with Chinese Support",
"version": "1.0.4",
"project_urls": {
"Homepage": "https://github.com/example/ticktick-mcp-v2",
"Issues": "https://github.com/example/ticktick-mcp-v2/issues",
"Repository": "https://github.com/example/ticktick-mcp-v2"
},
"split_keywords": [
"ticktick",
" mcp",
" model-context-protocol",
" task-management"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "cea35b8f86f344197cc62050148073bbe7a7a280377006bf2b7172e307ccb3d2",
"md5": "f81267cddd5fec34f57d0cfc8facccf9",
"sha256": "07ba81f368ca7c0775299c09e394deb87da435ef8bd96ea65b65d6140ae5ff3c"
},
"downloads": -1,
"filename": "ticktick_mcp_v2-1.0.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f81267cddd5fec34f57d0cfc8facccf9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 93520,
"upload_time": "2025-08-11T15:43:15",
"upload_time_iso_8601": "2025-08-11T15:43:15.904699Z",
"url": "https://files.pythonhosted.org/packages/ce/a3/5b8f86f344197cc62050148073bbe7a7a280377006bf2b7172e307ccb3d2/ticktick_mcp_v2-1.0.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "bdbde72e65dc52b4c81a847e7d02ba62cbbe1e69de500de40faa6f716be63728",
"md5": "ee790e86ed8cc5a7b434f55463ddb7bd",
"sha256": "1c9a1fe48a23474e7ff92cc2003e37835483325aab9a26712b55b14ff12984b6"
},
"downloads": -1,
"filename": "ticktick_mcp_v2-1.0.4.tar.gz",
"has_sig": false,
"md5_digest": "ee790e86ed8cc5a7b434f55463ddb7bd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 86778,
"upload_time": "2025-08-11T15:43:18",
"upload_time_iso_8601": "2025-08-11T15:43:18.318384Z",
"url": "https://files.pythonhosted.org/packages/bd/bd/e72e65dc52b4c81a847e7d02ba62cbbe1e69de500de40faa6f716be63728/ticktick_mcp_v2-1.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-11 15:43:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "example",
"github_project": "ticktick-mcp-v2",
"github_not_found": true,
"lcname": "ticktick-mcp-v2"
}
JSON
