AI Integration

Overview

TaskSpot integrates with AI tools like Claude Desktop and Claude.ai through the Model Context Protocol (MCP). This lets you manage your tasks using natural language — create tasks, check your to-do list, mark items complete, and more, all from your AI assistant.

Connect via Claude Desktop (Recommended)

1. Open Claude Desktop → Settings → Connectors
2. Click "Add Connector"
3. Enter the server URL: https://www.taskspot.app/api/mcp
4. Click Connect — you'll be redirected to TaskSpot to authorize
5. Sign in (if not already) and click "Authorize"
6. Done! Claude Desktop is now connected to your tasks.

This method automatically generates an API key for Claude. You can see and revoke it on your API Keys settings page (it appears as "OAuth: Claude Desktop").

Generate an API Key (Manual)

Go to Settings → API Keys in the TaskSpot web app. Enter a name for your key (e.g., "Claude Desktop"). Click Generate Key. Copy the key immediately — it's only shown once.

Connect Claude Desktop

Open your Claude Desktop configuration file at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).

{
  "mcpServers": {
    "taskspot": {
      "url": "https://www.taskspot.app/api/mcp",
      "headers": {
        "Authorization": "Bearer tsk_your_key_here"
      }
    }
  }
}

Replace tsk_your_key_here with your actual API key. Restart Claude Desktop to apply the changes.

Note: If you already have other MCP servers in your config and Claude Desktop crashes after adding TaskSpot, see the "Claude Desktop crashes on launch" item in Troubleshooting below.

Connect Cursor IDE

Add TaskSpot to Cursor via ~/.cursor/mcp.json (global) or .cursor/mcp.json (project). Use the production URL — Cursor cannot reach localhost unless you expose it (e.g. ngrok).

{
  "mcpServers": {
    "taskspot": {
      "url": "https://www.taskspot.app/api/mcp",
      "headers": {
        "Authorization": "Bearer tsk_your_key_here"
      }
    }
  }
}

Replace tsk_your_key_here with your API key. Restart Cursor after editing the config.

Connect Claude.ai

Go to Claude.ai Settings → Integrations → Add MCP Server. Enter the URL https://www.taskspot.app/api/mcp and add the Authorization header with your API key.

Available Commands

Once connected, you can ask your AI assistant to:

• Show my tasks — Lists tasks by category (today, tomorrow, backlog, upcoming, done, deleted)
• What's on my plate today? — Use list_tasks with filter "today"
• Add a task: Buy groceries — Uses create_task
• Mark 'Buy groceries' as done — Uses complete_task
• Update the priority of my task to high — Uses update_task
• Delete the task about groceries — Uses delete_task

Managing API Keys

You can create up to 5 API keys. Each key can be named for easy identification. View all your keys, their last-used dates, and revoke any key from Settings → API Keys. If you suspect a key has been compromised, revoke it immediately.

Troubleshooting

• Claude Desktop crashes on launch? Recent versions of Claude Desktop (v1.1.4088+) have a bug that crashes the app when 2 or more MCP servers are configured. Workaround: Remove other MCP servers from claude_desktop_config.json and keep only TaskSpot. You can add others back once Anthropic fixes the issue.
• Getting "Unauthorized" errors? Make sure your API key starts with tsk_ and hasn't been revoked. Generate a new key if needed.
• Invalid JSON or config errors? Ensure your config file has valid JSON — no trailing commas, all strings in double quotes. Use a JSON validator if unsure.
• Rate limited? The MCP server allows 60 requests per minute. If you hit this limit, wait a moment and try again.
• Tasks not showing up? Make sure you have tasks in the category you're querying. Try "list all my tasks for today".
• Cursor: "Error POSTing to endpoint" or "SSE error: Non-200 status code (404)"? Use the production URL https://www.taskspot.app/api/mcp — not localhost. Ensure mcp.json has valid JSON and the Authorization header with your API key. Restart Cursor after config changes.