Koskamo

Focuh MCP

An MCP server for the Focuh ADHD task management app, enabling AI agents to interact with tasks, loops, goals, calendar events, and focus statistics via tools like get_tasks, create_tasks, and get_calendar.

Visit Focuh

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Focuh MCP logo, by FocuhCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-06Published by Focuh
You need:Create a Bearer API key in Focuh under Settings → MCPMac and web require a Clerk account
MCP endpoint (Streamable HTTP)
https://www.focuh.com/api/mcp
Vendor documentation

What its tools do

14 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (6)

Can change data (8)

14 of 14 have a description · 14 of 14 declare behavior hints · 3 of 11 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Warning Advertises resources/templates/list but does not implement it
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • View today and tomorrow's tasks
  • Create tasks in bulk with nested subtasks
  • Retrieve calendar events and scheduled tasks
  • Get focus minutes and completion stats

Source and maintenance

Community listingRegistry 3.0.0
mcp-registry: io.github.maxxthedeveloper/focuh@3.0.0Source repositoryProject website
Maintenance checked

Protocol and capabilities

Server
Focuh 3.1.0
MCP protocol negotiated in check
2025-11-25
Tools
14 advertised
Resources
2 advertised
Resource templates
Not advertised
Prompts
2 advertised
Server-advertised capabilities
{
  "tools": {},
  "prompts": {},
  "resources": {}
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Focuh — focus timer and task manager. 14 tools. TOOLS: - Tasks: get_tasks, create_tasks, update_tasks, delete_tasks - Subtasks: get_subtasks, reorder_subtasks, create_tasks (parent or subtasks) - Loops: get_loops, pull_loops - Calendar: get_calendar - Goals: get_goals, create_goal, update_goal, delete_goal - Stats: get_focus_stats WORKFLOW: Call get_tasks first — it prints the id and date of every task. Mutations return per-task confirmations — do NOT call get_tasks after one. EVERY WRITE TOOL IS BULK. Pass every task in one call, never loop. - To move days or change priority: update_tasks {date, priority}. To change anything, never delete and recreate — deleting a task loses its subtasks, focus time, goal link and position. - Create a task with its subtasks in one create_tasks call. LOOPS: undated recurring intentions in four buckets (pressing/important/ backlog/waiting). pull_loops copies one onto a day as a linked task — the loop stays. Loops carry no priority and no date; buckets are the triage. waiting = parked; pulling or dating a waiting loop unparks it to backlog. REFERENCES: 'ref' takes the id shown in the list, #N, or an exact title. ROUTING: Use get_calendar (not get_tasks) for scheduling — it has events. POLICY: Only create tasks for actionable work, not events (lunch, gym). Current date: 2026-11-06 (Friday)

Tools

14 advertised

get_tasks — View Tasks
Advertised by the server during the last successful anonymous check.
Advertised read-only

Today/tomorrow tasks with id, date and priority. Call first to get refs.

get_tasks input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
get_tasks annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
create_tasks — Create Tasks
Advertised by the server during the last successful anonymous check.

Create tasks, each with optional nested subtasks. Defaults: today, 30 min.

create_tasks input schema
{
  "type": "object",
  "required": [
    "tasks"
  ],
  "properties": {
    "tasks": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title"
        ],
        "properties": {
          "date": {
            "type": "string",
            "maxLength": 10,
            "description": "Date"
          },
          "title": {
            "type": "string",
            "maxLength": 500,
            "description": "Title"
          },
          "goalId": {
            "type": "string",
            "maxLength": 64,
            "description": "Goal"
          },
          "parent": {
            "type": "string",
            "maxLength": 500,
            "description": "Parent"
          },
          "priority": {
            "enum": [
              "critical",
              "important",
              "nice-to-have"
            ],
            "type": "string",
            "description": "Priority"
          },
          "subtasks": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "title"
              ],
              "properties": {
                "title": {
                  "type": "string",
                  "maxLength": 500
                },
                "estimatedMinutes": {
                  "type": "number",
                  "maximum": 1440,
                  "minimum": 0
                }
              }
            },
            "maxItems": 100
          },
          "loopBucket": {
            "enum": [
              "pressing",
              "important",
              "backlog",
              "waiting"
            ],
            "type": "string",
            "description": "Undated loop; excludes date/priority; waiting=parked"
          },
          "estimatedMinutes": {
            "type": "number",
            "maximum": 1440,
            "minimum": 0,
            "description": "Minutes"
          }
        }
      },
      "maxItems": 100,
      "description": "Tasks to create"
    }
  }
}
create_tasks annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
update_tasks — Update Tasks
Advertised by the server during the last successful anonymous check.

Change tasks: date (moves the day), priority, title, estimate, done, time slot.

update_tasks input schema
{
  "type": "object",
  "required": [
    "tasks"
  ],
  "properties": {
    "tasks": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "ref"
        ],
        "properties": {
          "ref": {
            "type": "string",
            "maxLength": 500,
            "description": "Task id, #N, or title"
          },
          "date": {
            "type": "string",
            "maxLength": 10,
            "description": "Date"
          },
          "title": {
            "type": "string",
            "maxLength": 500,
            "description": "Title"
          },
          "goalId": {
            "type": "string",
            "maxLength": 64
          },
          "endTime": {
            "type": "string",
            "maxLength": 5,
            "description": "End"
          },
          "priority": {
            "enum": [
              "critical",
              "important",
              "nice-to-have"
            ],
            "type": "string",
            "description": "Priority"
          },
          "completed": {
            "type": "boolean",
            "description": "Done"
          },
          "startTime": {
            "type": "string",
            "maxLength": 5,
            "description": "Start"
          },
          "loopBucket": {
            "enum": [
              "pressing",
              "important",
              "backlog",
              "waiting"
            ],
            "type": "string",
            "description": "Into Loops or re-bucket; excl. date; waiting=parked"
          },
          "estimatedMinutes": {
            "type": "number",
            "maximum": 1440,
            "minimum": 0,
            "description": "Minutes"
          }
        }
      },
      "maxItems": 100,
      "description": "Changes to apply, one entry per task"
    }
  }
}
update_tasks annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
delete_tasks — Delete Tasks
Advertised by the server during the last successful anonymous check.
Advertised destructive

Delete tasks by ref, every task on a date, or all completed. Subtasks go too.

delete_tasks input schema
{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "maxLength": 10
    },
    "tasks": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 500
      },
      "maxItems": 100
    },
    "filter": {
      "enum": [
        "completed"
      ],
      "type": "string"
    }
  }
}
delete_tasks annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": true
}
get_subtasks — View Subtasks
Advertised by the server during the last successful anonymous check.
Advertised read-only

List subtasks of a parent. Returns ids usable as refs.

get_subtasks input schema
{
  "type": "object",
  "required": [
    "ref"
  ],
  "properties": {
    "ref": {
      "type": "string",
      "maxLength": 500,
      "description": "Task id, #N, or title"
    }
  },
  "additionalProperties": false
}
get_subtasks annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
reorder_subtasks — Reorder Subtasks
Advertised by the server during the last successful anonymous check.

Reorder a parent's subtasks. Pass the complete new order, every one once.

reorder_subtasks input schema
{
  "type": "object",
  "required": [
    "ref",
    "order"
  ],
  "properties": {
    "ref": {
      "type": "string",
      "maxLength": 500,
      "description": "Task id, #N, or title"
    },
    "order": {
      "type": "array",
      "items": {
        "type": [
          "number",
          "string"
        ],
        "maxLength": 64
      },
      "maxItems": 100
    }
  }
}
reorder_subtasks annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_loops — View Loops
Advertised by the server during the last successful anonymous check.
Advertised read-only

Loops — undated intentions in 4 buckets (pressing/important/backlog/waiting=parked). Call before pull_loops.

get_loops input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
get_loops annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
pull_loops — Pull Loops
Advertised by the server during the last successful anonymous check.

Copy loops onto a date as linked tasks — each loop stays in Loops. Idempotent per loop+date.

pull_loops input schema
{
  "type": "object",
  "required": [
    "loops"
  ],
  "properties": {
    "date": {
      "type": "string",
      "maxLength": 10
    },
    "loops": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 500
      },
      "maxItems": 100
    }
  }
}
pull_loops annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_calendar — View Calendar
Advertised by the server during the last successful anonymous check.
Advertised read-only

Events + scheduled/unscheduled tasks for a date. Check before scheduling.

get_calendar input schema
{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "maxLength": 10
    }
  },
  "additionalProperties": false
}
get_calendar annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_goals — View Goals
Advertised by the server during the last successful anonymous check.
Advertised read-only

Goals by horizon (week/month/year/decade) — exactly what the app's Goals view shows.

get_goals input schema
{
  "type": "object",
  "properties": {
    "status": {
      "enum": [
        "active",
        "completed",
        "all"
      ],
      "type": "string"
    },
    "horizon": {
      "enum": [
        "week",
        "month",
        "year",
        "decade"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}
get_goals annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
create_goal — Create Goal
Advertised by the server during the last successful anonymous check.

Create a goal in a horizon, with optional bottleneck note and lever.

create_goal input schema
{
  "type": "object",
  "required": [
    "title",
    "horizon"
  ],
  "properties": {
    "lever": {
      "type": "string",
      "maxLength": 5000
    },
    "title": {
      "type": "string",
      "maxLength": 500
    },
    "horizon": {
      "enum": [
        "week",
        "month",
        "year",
        "decade"
      ],
      "type": "string"
    },
    "bottleneckNote": {
      "type": "string",
      "maxLength": 5000
    }
  }
}
create_goal annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
update_goal — Update Goal
Advertised by the server during the last successful anonymous check.

Update goal fields: title, horizon (moves section), status, bottleneckNote, lever.

update_goal input schema
{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 64
    },
    "lever": {
      "type": "string",
      "maxLength": 5000
    },
    "title": {
      "type": "string",
      "maxLength": 500
    },
    "status": {
      "enum": [
        "active",
        "completed",
        "paused",
        "dropped"
      ],
      "type": "string"
    },
    "horizon": {
      "enum": [
        "week",
        "month",
        "year",
        "decade"
      ],
      "type": "string"
    },
    "bottleneckNote": {
      "type": "string",
      "maxLength": 5000
    }
  }
}
update_goal annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
delete_goal — Delete Goal
Advertised by the server during the last successful anonymous check.
Advertised destructive

Delete a goal by id. Linked tasks are kept and unlinked, never deleted.

delete_goal input schema
{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 64
    }
  },
  "additionalProperties": false
}
delete_goal annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": true
}
get_focus_stats — Focus Statistics
Advertised by the server during the last successful anonymous check.
Advertised read-only

Today/week focus minutes, streak, task completion rates.

get_focus_stats input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
get_focus_stats annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

2 advertised

plan-my-day

Advertised by the server during the last successful anonymous check.

Plan your day by reviewing tasks, calendar, and suggesting an optimized schedule

date
YYYY-MM-DD date to plan (default: today)
weekly-review

Advertised by the server during the last successful anonymous check.

Review the week's progress, bottlenecks, and plan next week's priorities

No arguments advertised.

Resources

2 advertised

Today's Tasks

Advertised by the server during the last successful anonymous check.

Current tasks for today and tomorrow with status, time estimates, and schedule

Today's Tasks URI
todos://today

MIME type: text/plain

Agent Guide

Advertised by the server during the last successful anonymous check.

Complete guide to Focuh MCP tools, workflows, and capabilities including subtask support

Agent Guide URI
focuh://guide

MIME type: text/markdown

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (2 of 2 answered).

  1. 2026-11-06: 1 of 1 checks answered
  2. 2026-11-07: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
985 ms
95th percentile latency
985 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 985 ms · metadata changed · 14 tool(s), 2 resource(s), 2 prompt(s); warnings: Advertises resources/templates/list but does not implement it

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http focuh-mcp https://www.focuh.com/api/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add focuh-mcp --url https://www.focuh.com/api/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable focuh-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "focuh-mcp": {
      "url": "https://www.focuh.com/api/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "focuh-mcp": {
      "type": "streamableHttp",
      "url": "https://www.focuh.com/api/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start focuh-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "focuh-mcp": {
      "type": "http",
      "url": "https://www.focuh.com/api/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http focuh-mcp https://www.focuh.com/api/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://www.focuh.com/api/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "focuh-mcp": {
      "serverUrl": "https://www.focuh.com/api/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Focuh MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 5,461