Manage Your Tasks from Claude with TaskSpot MCP

TaskSpot Team• March 7, 2026

TaskSpot now works with AI assistants through the Model Context Protocol (MCP). You can manage your tasks from Claude Desktop, Claude.ai, or any MCP-compatible tool — without opening the TaskSpot app. Ask "what's on my plate today?" and get your list. Say "add a task: call the dentist" and it's done. Your AI assistant becomes your task manager.

What Is MCP?

The Model Context Protocol is an open standard that lets AI tools connect to external data and tools. Instead of the AI guessing or hallucinating your task list, it talks directly to TaskSpot. Your tasks stay in TaskSpot. Your AI gets real-time access to create, read, update, and complete them.

This matters because it's vendor-neutral. MCP works with Claude today, and it will work with other AI tools as they adopt the protocol. You're not locked into one assistant.

What You Can Do

TaskSpot's MCP server exposes many tools that map to natural language — including listing and searching tasks, creating and updating them (with optional hashtags in titles), completing or deleting, bulk actions, stats, workload helpers, tag discovery, and more.

Examples:

List tasks — Filter by today, tomorrow, backlog, upcoming, done, or deleted; narrow by tag when your titles include hashtags.
List tags — See which #tags appear across your tasks.
Get a task — Fetch details by task number (for example #42) or by ID.
Create / update / move tasks — Set title (including #tags), description, priority, due date, urgency, repeat, focus, parent for sub-tasks, and more.
Complete / bulk complete / delete — Mark progress or soft-delete (recover from Deleted in the web app).

Concrete examples:

"What's on my plate today?" → lists today's tasks
"Add a task: Buy groceries" → creates a backlog task
"Add a task: Review the proposal, due tomorrow, high priority" → creates a task with metadata
"Mark 'Buy groceries' as done" → completes that task
"Delete the task about the dentist" → soft-deletes it
"What tags am I using?" or "Show tasks tagged #work" → uses tag-aware listing
"Mark #7 done" or "Snooze #12 to tomorrow" → resolves the short task number from your list (click #N in TaskSpot to copy)

The AI uses these tools behind the scenes. You just talk.

Task numbers (#N)

Every task in TaskSpot gets a short reference like #42 — shown on your list and stable across sessions. Click the number in the app to copy it, then paste into Claude or paste it into a prompt. When you say "mark #7 done," the MCP server maps that number to the right task without you hunting for a UUID or paraphrasing the title.

That is different from #tags in titles: #work is a hashtag for filtering; #42 on the badge is the task's reference number for AI shorthand. Both work in the same conversation — your assistant picks the right meaning from context.

Getting Started

Go to Settings → API Keys in TaskSpot (requires TaskSpot Plus or an active trial).
Enter a name for your key (e.g., "Claude Desktop") and click Generate Key.
Copy the key immediately — it's shown only once.
Add the MCP server to Claude Desktop or Claude.ai. For Claude Desktop, edit your config file and add:

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

Restart Claude Desktop. The TaskSpot tools are now available.

For Claude.ai, go to Settings → Integrations → Add MCP Server. Enter the URL and add the Authorization header with your API key.

See the full setup guide for step-by-step instructions, including Windows paths and troubleshooting.

Use Cases

Quick capture during a conversation — You're chatting with Claude about a project. A follow-up task comes up. "Add a task: Send the report to Sarah by Friday." Done. No context switch.

Morning review — "What's on my plate today?" You get your Today list. Decide what to tackle first without opening another app.

Batch task creation from meeting notes — Paste meeting notes into Claude. "Create tasks for each action item." Claude parses the notes and creates tasks in TaskSpot.

Hands-free completion — You're cooking or driving. "Mark 'Pick up dry cleaning' as done." Voice or text, the task is completed.

Repeating tasks — "Mark my daily standup task as done." If it's a repeating task, TaskSpot creates the next occurrence automatically. Same behavior as the web app.

Security and Privacy

API keys are hashed — We store only a SHA-256 hash. The plaintext key is shown once at creation and never stored.
Keys are revocable — Revoke any key from Settings → API Keys. AI tools using that key stop working immediately.
Usage is logged — Every MCP call is logged (tool name, status, duration). Task content (titles, descriptions) is not logged to protect privacy.
Rate limited — 60 requests per minute per user. Prevents abuse.
Task content is encrypted — TaskSpot encrypts task text at rest. The MCP server uses the same encryption as the web app.

Try It Now

Sign up for TaskSpot and start a free trial. Go to Settings → API Keys to generate your first key, then connect Claude. Your AI assistant can now manage your tasks.