MCP server & tools

The local tool surface your agent uses to operate Qalatra.

Qalatra runs a Model Context Protocol server at http://localhost:3457/mcp. Any MCP-aware local agent can connect and work with tasks, notes, habits, agent jobs, heartbeats, and capability discovery.

Transport

Streamable HTTP. Standard MCP. See the MCP spec for protocol details.

Claude Code config

{
  "mcpServers": {
    "qalatra": {
      "type": "http",
      "url": "http://localhost:3457/mcp"
    }
  }
}

Tool catalog

Tasks and triage

Tool	What it does
`get_todays_tasks`	Today view with active, overdue, due, events, reminders, and habits
`get_overdue_tasks`	Overdue active tasks
`get_task`	Single task by id
`create_task`	New task; all fields optional except title
`update_task`	Patch any field
`complete_task`	Mark done
`snooze_task`	Defer until a later date
`search_tasks`	Full-text
`rename_project`	Rename across all tasks

Daily notes

`get_daily_note`	Get a note by date
`update_daily_note`	Replace a date's markdown content
`get_week_notes`	Get the seven daily notes ending on a date

Habits

`list_habits`	Habit list with recent status
`log_habit`	Mark a habit done or skipped
`create_habit`	Create a new habit
`get_habit_history`	Read a habit's log history

Agents and heartbeats

`queue_agent_job`	Queue a task for its assigned agent
`list_agent_jobs`	List recent jobs, optionally by task
`get_agent_job`	Read one job's status and result
`list_heartbeats`	Scheduled background agents
`create_heartbeat`	Create a recurring background agent run

Capabilities

`list_capabilities`	List structured capabilities derived from agent folders
`search_capabilities`	Find relevant agents, skills, workflows, or knowledge by intent
`get_capability`	Inspect files, permissions, and delegation metadata
`rescan_capabilities`	Refresh the registry from disk

Rate limits

None. It's your machine.

Security

MCP binds to 127.0.0.1 by default. Do not expose MCP through a public tunnel. For remote access, expose only the token-authenticated Qalatra API; see Remote instances.