Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
DWT_TOKENNoAPI token. Defaults to reading from ~/.deepworktimer/token if not set.~/.deepworktimer/token
DWT_SOURCENoDevice label shown on sessions started here.mcp:<hostname>
DWT_BASE_URLNoBase URL of the API. Point at a self-hosted instance.https://deepworktimer.com

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
dwt_statusA

Show the active Deep Work Timer session (if any: task, time remaining, which device owns it) and today's total focus time. Call this first before starting or logging anything.

dwt_statsA

Total focus time for today, last 7 days, last 30 days, last 365 days and all time, plus best day and 30-day daily average.

dwt_lifetime_skillsA

The 10,000-hour ledger: lifetime focus hours for every #skill the user has tagged, sorted by hours, with the next milestone. Use to answer 'how many hours have I put into X'.

dwt_deposits_todayB

Today's ledger statement: each completed focus session with its tasks and minutes.

dwt_list_projectsA

List the user's projects (id, name). Tasks live in projects or unassigned.

dwt_create_projectB

Create a project to group tasks (e.g. a repo, a course, a certification).

dwt_list_tasksA

List open tasks. Without project_id returns unassigned tasks; with it, that project's tasks. Set snoozed=true to see snoozed tasks instead.

dwt_create_taskA

Create a task. Put skills in the description as #tags (e.g. 'Fix auth bug #python #django @1h'); an @Nh/@Nm marker sets the estimate. #tags only attach to skills that already exist on the account. Returns the created task with its attached skills.

dwt_complete_taskD

Mark a task as completed.

dwt_start_sessionA

Start a server-side focus session (default length: the account's pomodoro setting, usually 25 min; 1 to 240 minutes). There is ONE active session per account: starting takes over any session running on another device, so call dwt_status first and prefer dwt_switch_task when a session is already running.

dwt_switch_taskA

Move the active session's open segment to a different task. Time is split honestly between tasks; total is conserved. Use this instead of dwt_start_session when a session is already running.

dwt_log_sessionA

Complete the active session and write it to the ledger as one pomodoro, split across the tasks it touched. Refuses if another device currently owns the open segment (the user may be working there) unless force=true and the user explicitly asked.

dwt_abandon_sessionA

Discard the active session without logging any time.

dwt_log_pomodoroC

Record focus time that already happened (no running session): N minutes on one task, written to the ledger now.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/stirredo/deepworktimer-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server