he page 5. Copy this token and set it as the TICKTICK_ACCESS_TOKEN environment variable ### Generate Access Token When you need to generate a new access token (either for first-time setup or when the token expires), follow these steps: 1. Configure your credentials using one of these methods: #### Option 1: .env file (Recommended) Create a `.env` file in your project root: ```bash TICKTICK_CLIENT_ID="" TICKTICK_CLIENT_SECRET="" ``` Then load it: ```bash source .env ``` This method is recommended because: - Credentials persist between terminal sessions - Easier to manage multiple configurations - Less prone to shell history leaks - Can be easily backed up (remember to exclude from version control) #### Option 2: Terminal Environment Variables Use single quotes if your credentials contain special characters. Note that these variables will only persist in your current terminal session: ```bash export TICKTICK_CLIENT_ID='' export TICKTICK_CLIENT_SECRET='' ``` 2. Run the authentication command: If using the published package: ```bash npx @alexarevalo.ia/mcp-server-ticktick ticktick-auth ``` If running the MCP server locally: ```bash npm run start:auth ``` The process will: - Launch your default browser - Direct you to TickTick's login page - Request necessary permissions - Generate and display your access token 3. Save the access token: ```bash echo "TICKTICK_ACCESS_TOKEN=\"\"" >> .env source .env ``` > **Security Tips**: > > - Add `.env` to your `.gitignore` file > - Never commit credentials to version control > - Access tokens expire after 180 days - you'll need to regenerate them ### Usage with Claude Desktop To use this with Claude Desktop, add the following to your `claude_desktop_config.json`: ### NPX ```json { "mcpServers": { "ticktick": { "command": "npx", "args": ["-y", "@alexarevalo.ai/mcp-server-ticktick"], "env": { "TICKTICK_CLIENT_ID": "", "TICKTICK_CLIENT_SECRET": "", "TICKTICK_ACCESS_TOKEN": "" } } } } ``` #### Docker ```json { "mcpServers": { "ticktick": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "TICKTICK_CLIENT_ID", "-e", "TICKTICK_CLIENT_SECRET", "-e", "TICKTICK_ACCESS_TOKEN", "mcp/ticktick" ], "env": { "TICKTICK_CLIENT_ID": "", "TICKTICK_CLIENT_SECRET": "", "TICKTICK_ACCESS_TOKEN": "" } } } } ``` ### Installing via Smithery To install ticktick-mcp-server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@alexarevalo9/ticktick-mcp-server): ```bash npx -y @smithery/cli install @alexarevalo9/ticktick-mcp-server --client claude ``` ### Build Docker build: ```bash docker build -t mcp/ticktick -f src/ticktick/Dockerfile . ``` ## License This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.2a:T60d,## what is TickTick MCP Server? TickTick MCP Server is an API server that enables task management, project organization, and habit tracking using the TickTick API. ## how to use TickTick MCP Server? To use the TickTick MCP Server, register your application with TickTick to obtain API credentials, then follow the setup instructions to authenticate and interact with the API. ## key features of TickTick MCP Server? - ✅ **Task Management**: Create, read, update, and delete tasks with all available properties. - 📊 **Project Management**: Manage projects with customizable views. - 📋 **Subtask Support**: Manage subtasks within parent task

TickTick MCP Server

ツール