liadgez/ticktick-mcp-server

# Now this works perfectly!
ticktick_get_cached_tasks()           # List all cached tasks
ticktick_register_task_id()           # Add existing tasks  
ticktick_import_from_csv()            # Bulk import
# All new tasks auto-cached ✨

# Build the image
docker build -t ticktick-mcp .

# Run the container
docker run -d \
  --name ticktick-mcp \
  -e TICKTICK_ACCESS_TOKEN=your_token \
  -p 8007:8007 \
  ticktick-mcp

{
  "mcpServers": {
    "ticktick": {
      "command": "node",
      "args": ["/path/to/ticktick-mcp/src/index.js"],
      "env": {
        "TICKTICK_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

// 🎉 The breakthrough feature - list all your tasks!
await ticktick_get_cached_tasks();
// Returns: All cached tasks with fresh/stale status

// Register existing tasks for discovery
await ticktick_register_task_id({
  task_id: "existing_task_123",
  project_id: "project_456", 
  title: "My Existing Task"
});

// Import tasks from CSV export
await ticktick_import_from_csv({
  csv_data: "task_id,project_id,title\ntask1,proj1,Design\ntask2,proj1,Development"
});

// Filter cached tasks by project
await ticktick_get_cached_tasks({ project_id: "specific_project" });

// Create a new task (auto-cached! ✨)
await ticktick_create_task({
  title: "Review Claude Code documentation",
  project_id: "inbox",
  priority: 3,
  due_date: "2024-12-31"
});
// Task automatically appears in cache for easy discovery

// Get all projects
await ticktick_get_projects({ include_archived: false });

// Complete a task
await ticktick_complete_task({ task_id: "task123" });

// Start a focus session
await ticktick_start_focus_session({
  duration: 25, // Pomodoro: 25 minutes
  task_id: "task123"
});

// Track habit completion
await ticktick_check_in_habit({
  habit_id: "habit456",
  date: "2024-01-15"
});

// Generate productivity report
await ticktick_get_productivity_report({
  period: "week",
  include_charts: true
});

// ❌ THESE BREAK SYNC (avoid in task content):
"content": "Line 1\nLine 2"           // Actual newlines
"content": "Path: C:\\Users\\folder"  // Backslashes  
"content": "Literal \\n in text"     // Escape sequences
"content": "Quote: \"hello\""        // Escaped quotes in content

// ✅ THESE ARE SAFE (work perfectly):
"content": "Emojis work: 💻🚀📊✅❌🔧🎯📁⚡🤖"     // All emojis
"content": "Arrows: → ← ↑ ↓ ↗ ↖ ↘ ↙"               // All arrows  
"content": "Bullets: • ○ ■ ▪ ▫ ◦ ‣"                // All bullets
"content": "Unicode: ñ é ü ç § ± © ® ™"             // All Unicode
"content": "JSON: { } [ ] and arrays [1,2,3]"      // JSON chars
"content": "Markdown: # header *bold* **strong**"   // Markdown
"content": "Quotes work fine in content"            // Regular quotes

# ✅ WORKING - Basic task creation
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ticktick_create_task","arguments":{"title":"My Task","content":"Safe content without newlines or backslashes","project_id":"your_project_id"}}}' | node src/index.js

# ✅ WORKING - With emojis and arrows  
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ticktick_create_task","arguments":{"title":"💻 Coding Task","content":"Use arrows for workflow: Plan → Code → Test → Deploy 🚀","project_id":"your_project_id"}}}' | node src/index.js

# Test if your token works
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ticktick_get_projects","arguments":{}}}' | node src/index.js

# Create a test task (should appear in your TickTick app)
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ticktick_create_task","arguments":{"title":"API Test","content":"This task should appear in your TickTick app within seconds"}}}' | node src/index.js

# Read specific task (requires both project_id and task_id)
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ticktick_get_task_details","arguments":{"project_id":"YOUR_PROJECT_ID","task_id":"YOUR_TASK_ID"}}}' | node src/index.js

# 🎯 CRITICAL: Read inbox tasks (special project ID discovered!)
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ticktick_get_task_details","arguments":{"project_id":"inbox125308274","task_id":"YOUR_TASK_ID"}}}' | node src/index.js

# Test cache functionality
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ticktick_get_cached_tasks","arguments":{}}}' | node src/index.js

# Test task registration  
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ticktick_register_task_id","arguments":{"task_id":"test123","project_id":"proj456","title":"Test Task"}}}' | node src/index.js

# Test CSV import
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ticktick_import_from_csv","arguments":{"csv_data":"task_id,project_id,title\ntask1,proj1,Test"}}}' | node src/index.js

# Test basic functionality
node validate-ticktick-mcp.js

# Test character compatibility (recommended before using)
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ticktick_create_task","arguments":{"title":"Compatibility Test","content":"Testing safe characters: emojis 💻, arrows →, unicode é, bullets •"}}}' | node src/index.js