Connect Claude or Cursor to your surf log

Sessions has an MCP server, so Claude, Cursor and other assistants can read and log your sessions.

1. Generate a token

Sign in, open your profile, and under Connect to Claude click Generate new token. Copy it; it’s only shown once.

The token can read, edit and delete your sessions. Don’t share it. Revoke it on the same page if it leaks.

2. Add the server to your client

The server URL is:

https://mtlfvcuuyejwksicvktd.supabase.co/functions/v1/mcp-server/mcp

Requests authenticate with Authorization: Bearer <token>. Replace YOUR_TOKEN below with your token. The profile page shows these snippets with it filled in.

Claude Code

Run this, then type /mcp in Claude Code to check it’s connected:

claude mcp add --transport http sessions https://mtlfvcuuyejwksicvktd.supabase.co/functions/v1/mcp-server/mcp \
--header "Authorization: Bearer YOUR_TOKEN"

Add --scope user to use it in every project.

Claude Desktop

Open Settings → Developer → Edit Config, add this to claude_desktop_config.json, and restart. It uses mcp-remote, which needs Node 18 or later:

{
"mcpServers": {
  "sessions": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://mtlfvcuuyejwksicvktd.supabase.co/functions/v1/mcp-server/mcp",
      "--header",
      "Authorization: Bearer YOUR_TOKEN"
    ]
  }
}
}

If you already have an mcpServers block, add the "sessions" entry to it.

Cursor

Add the same entry to ~/.cursor/mcp.json or a project’s .cursor/mcp.json, then enable it under Settings → MCP.

Other clients

Any client that supports streamable HTTP with a custom header works. To check a token, list the tools:

curl -sN https://mtlfvcuuyejwksicvktd.supabase.co/functions/v1/mcp-server/mcp \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

3. Try it

  • “Log a session at Ocean Beach this morning: 90 minutes, waist-high, fair, 3 stars.”
  • “Which spot did I surf most last month?”
  • “Set Saturday’s rating to 5.”
  • “How many hours did I surf this year?”

Tools

Tool What it does
list_sessions List sessions, newest first
get_session Get one session, with its voice note
create_session Log a session
update_session Edit a session
delete_session Delete a session, after confirming
re_enrich_session Fill empty fields from a session’s voice note
search_spots Find a spot by name
list_boards List active boards
list_fins List active fins

See also tracking your boards and fins and logging a session.

Questions

Which assistants work?
Any MCP client that supports streamable HTTP with a custom header. Claude Desktop and Cursor use the mcp-remote bridge.
What can the assistant see?
Your sessions, active boards and fins, and the spot directory. It can also create, edit and delete sessions.
Will it delete sessions without asking?
No. The first delete call only shows what would be deleted. It takes a second call to confirm.
How do I disconnect it?
Revoke the token on your profile page.

Start logging.

It’s free.

Create a free account