Intend MCP Server

Intend supports MCP (Model Context Protocol), allowing AI assistants like Claude to interact with your intentions, timer, and goals directly.

Intend hosts an MCP server at https://intend.do/mcp that you can connect to from claude.ai or other MCP-compatible tools.

MCP

Setup for claude.ai

  1. Go to claude.ai Settings → Integrations
  2. Click "Add integration" and select "Custom MCP server"
  3. Enter these details:
    • Name: Intend
    • URL: https://intend.do/mcp
  4. Save. Then hit Connect, and then Allow on the next page, and Claude will now be able to check your intentions, mark them complete, control your timer, and more!

Setup for Claude Code (CLI)

  1. Add the MCP server:
    claude mcp add --transport http intend https://intend.do/mcp
  2. In Claude Code, run the /mcp command and select "Authenticate" for Intend
  3. Follow the OAuth flow in your browser to log in and authorize access
  4. Claude Code can now manage your intentions, timer, and goals!

Note: If you need to re-authenticate later, use /mcp again and select "Clear authentication" then "Authenticate".


Available MCP Tools

ToolDescription
get_current_intentionGet your current/next intention to work on
get_intentions_listGet your full intentions list for today
complete_intentionMark an intention as complete
not_todaySkip an intention (remove from today's list)
defer_nextDefer current intention to after the next item
defer_lastDefer intention to end of list
move_to_currentMove an intention to the current position
set_nowPin an intention as the "now" focus
clear_nowClear the now focus
add_intentionAdd new intention(s)
append_to_intentionAppend text to an existing intention
pick_randomRandomly select a different intention
get_timerGet current timer status
start_pomodoroStart a pomodoro timer
start_countdownStart a countdown/hourglass timer
start_breakStart a break timer
pause_timerPause the timer (hourglass only)
unpause_timerResume a paused timer
cancel_timerCancel the timer
get_goalsGet your goals (active or all)

Example Usage

Once connected, you can ask Claude things like:

  • "What's my current intention?"
  • "Mark that as complete"
  • "Start a 25 minute pomodoro"
  • "What are my goals?"
  • "Add a new intention: review pull request"
  • "Defer my current task to later"

Looking for the REST API? See the API documentation.