AI Assistant Integration (MCP)

MCP Tools

What your AI can do

Once connected, your AI assistant has access to nineteen tools covering tasks, habits, and hands-free workout coaching. Streak data is included in the habit listing response.

List Tasks

Retrieve your task list filtered by status: active (default, excludes parked), completed, parked (Parking Lot only), or all. Ask "what are my top tasks today?" and get a ranked answer.

list_tasks

Search Tasks

Full-text search across all your tasks by keyword, person name, company, or topic. Searches title, notes, contact, and company fields — returns ranked results so your AI can find the right task even without an exact ID.

search_tasks

Create a Task

Add a task with full detail in one sentence: title, deadline, urgency, importance, priority, estimated time, recurrence, category, project, contact name, company, ROI weight, focus/pin flags, long-term flag, and Parking Lot routing — all supported.

create_task

Update a Task

Change any field on an existing task — title, deadline, urgency, status, progress %, importance, recurrence, category, project, contact, ROI weight, focus/pin flags, long-term flag, or park/unpark — only the fields you mention are touched.

update_task

Complete a Task

Mark any task as done through your AI. Great for debriefing a meeting or wrapping up a session by telling your AI what you finished.

complete_task

Snooze a Task

Push a task out of immediate focus until a specific date. Sets the snooze-until date and increments the snooze penalty in the priority algorithm so the task resurfaces naturally. Optionally logs the reason in the task notes.

snooze_task

List Habits

Check today's habit schedule, completion status, and current streaks. Your AI can give you a morning briefing of all your daily habits, including streak counts.

list_habits

Complete a Habit

Record a habit completion for today — including quantity or duration for measurable habits — without opening the app.

complete_habit

Update a Habit

Rename a habit, change its target quantity, switch its time slot (Morning / Anytime / Evening), or adjust its type.

update_habit

Get a Task

Fetch the full details of any single task by ID — title, urgency, priority, deadline, status, progress, notes, duration, importance, recurrence, category, project, contact, focus/pin flags, ROI weight, and Parking Lot state.

get_task

List Workout Plans

See all your workout plans with their full exercise lists — names, sets, reps, and weights — so your AI can coach you through any of them.

list_workout_plans

Start a Workout

Kick off a workout session from any plan. Your AI announces the first exercise and set so you can get started immediately — hands-free.

start_workout

Active Workout Status

Check the current session at any time — which sets are done, what's next, target reps and weight, and overall progress through the plan.

get_active_workout

Complete a Set

Mark the current set as done — with your actual reps and weight if you want. Your AI immediately tells you what exercise is up next.

complete_workout_set

Finish Workout

Log and close the session when all sets are done. Your AI summarizes total sets, time, and volume — and syncs everything back to the app.

finish_workout

List Categories

Retrieve all your task categories with their IDs. Use these IDs when creating or updating a task to assign it to the right category.

list_categories

List Projects

Retrieve all your projects with their IDs and colors. Use these IDs when creating or updating a task to assign it to the right project.

list_projects

Park a Task

Tell your AI to park any task and it moves to the Parking Lot instantly — out of active prioritization until you're ready to return to it.

park_task

Unpark a Task

Pull a task back from the Parking Lot and return it to your active list. Your AI handles the lookup and restore in one step.

unpark_task

Real Examples

What it looks like in practice

These are real conversations you can have with your AI once 10 to Win is connected. The AI uses the tools behind the scenes — you just talk naturally.

Morning Briefing

You

What are my top 5 tasks right now? Focus on anything urgent or overdue.

Here are your top 5 active tasks:

1. Call Mike re: contract renewal — Emergency, overdue by 1 day
2. Submit expense report — Urgent, due today
3. Review Johnson proposal — Urgent, due tomorrow
4. Send Q2 update to team — High, due Thursday
5. Follow up with Sarah — High, no deadline

Want me to mark any of these complete or snooze anything?

Tools used: list_tasks

Create & Organize

You

Add a task to prepare the investor deck, high priority, deadline next Friday. Also snooze the Johnson proposal — I can't deal with it until Tuesday.

Done — two things taken care of:

Created: "Prepare investor deck" — priority 8, deadline May 23
Snoozed: "Review Johnson proposal" — will resurface Tuesday May 20

Tools used: search_tasks create_task snooze_task

Habits & Workout

You

Check my habit streaks and start my morning workout.

Your habit streaks:
Meditation — 7-day streak
Morning walk — 4-day streak
Read 10 pages — 2-day streak (at risk today)

Morning Strength workout started. First up: Barbell Squat — 3 sets of 8 at 185 lbs. Say "done" when your first set is complete.

Tools used: list_habits list_workout_plans start_workout

Search & Update

You

Find all tasks related to Acme Corp and bump their priority to urgent.

Found 3 tasks for Acme Corp — all updated to Urgent priority:

1. "Send revised contract to Acme" — was High, now Urgent
2. "Schedule demo call with Acme team" — was Moderate, now Urgent
3. "Follow up on Acme invoice" — was Low, now Urgent

Tools used: search_tasks update_task ×3

Configuration

Connect your AI in minutes

Generate an API key in the app under Settings → AI Assistant, then paste the config below into your AI tool of choice.

Claude Desktop, Cursor, Windsurf, Cline, Zed For Claude Desktop: open Settings → Developer → Edit Config and paste this JSON into claude_desktop_config.json, then restart Claude.

For Cursor, Windsurf, Cline, or Zed: add this to your MCP settings and restart the app.

{
  "mcpServers": {
    "10towin": {
      "url": "https://10towin.co/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Raycast, LibreChat, Jan, and any other HTTP MCP client Copy the server URL and your API key separately and paste them into your client's MCP settings. Replace YOUR_API_KEY with the key generated in the app.

MCP Server URL

https://10towin.co/mcp

API Key Format

Authorization: Bearer YOUR_API_KEY

Generate your API key in the app: Settings → AI Assistant → Set Up AI Assistant

Machine-readable manifest: 10towin.co/mcp-manifest.json — used by MCP directory crawlers and AI clients for auto-discovery.

How It Works

Up and running in four steps

No developer account needed. Your data stays on your server — the AI reads and writes through the secure MCP channel.

Download 10 to Win and sign in

Create your account in the app. A free account is all you need to use the AI integration.

Open Settings → AI Assistant

Tap "Set Up AI Assistant" to run through the two-minute setup wizard. Give your key a label (e.g. "My MacBook Claude") and tap Create.

Copy the config for your AI tool

The wizard shows ready-to-paste config for Claude and friends, or a raw URL for any other client. Pick your tab and tap Copy.

Paste and restart your AI client

Paste the config into your AI tool's settings, restart it, and your 10 to Win tools will appear. Ask your AI "what are my tasks today?" to verify it's working.

Supported Clients

Works with every MCP-compatible AI tool

Your 10 to Win MCP server speaks the Streamable HTTP transport — the modern standard supported across all leading AI clients and IDEs.

Claude Desktop

Recommended

The original MCP client from Anthropic. Full tool support, streaming responses, and the best integration depth. Works on Mac and Windows.