TickTick MCP Server (Vercel)

# TickTick MCP Server (Vercel) A Model Context Protocol server for TickTick, deployed on Vercel. ## Deploy to Vercel [](https://vercel.com/new/clone?repository-url=https://github.com/YOUR_USERNAME/ticktick-mcp-vercel) ### 1. Environment Variables Set these in Vercel Dashboard > Settings > Environment Variables: | Variable | Description | |----------|-------------| | `TICKTICK_ACCESS_TOKEN` | Your TickTick API access token | | `REDIS_URL` | Redis connection URL (for SSE transport) | ### 2. Add Redis (for SSE support) 1. Go to Vercel Dashboard > Storage 2. Add **Upstash Redis** 3. The `REDIS_URL` will be automatically configured ### 3. Deploy ```bash vercel --prod ``` ## Connect from Claude ### Option 1: Claude Pro/Max/Team/Enterprise 1. Open Claude Desktop or claude.ai 2. Go to **Settings > Connectors** 3. Add new connector with URL: `https://your-app.vercel.app/api/mcp` ### Option 2: Using mcp-remote (Free users) Edit `~/Library/Application Support/Claude/claude_desktop_config.json`: ```json { "mcpServers": { "ticktick": { "command": "npx", "args": [ "mcp-remote", "https://your-app.vercel.app/api/sse" ] } } } ``` ## Available Tools | Tool | Description | |------|-------------| | `list_projects` | List all TickTick projects | | `get_tasks` | Get tasks (all or by project) | | `create_task` | Create a new task | | `update_task` | Update an existing task | | `complete_task` | Mark task as completed | | `delete_task` | Delete a task | ## Local Development ```bash # Install dependencies npm install # Set environment variables export TICKTICK_ACCESS_TOKEN="your-token" export REDIS_URL="your-redis-url" # Optional for local # Run development server npm run dev ``` Test with MCP Inspector: ```bash npx @anthropic-ai/mcp-inspector ``` ## Endpoints - `/api/mcp` - Streamable HTTP transport (recommended) - `/api/sse` - Server-Sent Events transport