Connect AlmRecorder to Cursor

Before you begin: confirm that AlmRecorder has Settings → MCP. If it is missing, install a version with MCP support.

Configure AlmRecorder as a local MCP server for Cursor on this Mac.

Work carefully and perform the setup for me if you have filesystem and terminal access. If you cannot edit local files, return the exact ready-to-paste file change and tell me where it belongs.

1. First confirm that AlmRecorder shows Settings → MCP, is in its final app location, and is open.
2. Ask me to enable Enable local MCP server, wait for Listening on …, and choose Copy configuration.
3. I will append the copied JSON configuration below this task. Ask me for it if it is missing.
4. Treat ALMRECORDER_MCP_TOKEN like a password. Never repeat it in your response, log it, or put it in Git, a support issue, or a shared project file.
5. Merge the almrecorder entry under mcpServers in the global file ~/.cursor/mcp.json. Preserve every existing server.
6. Use the exact command, ALMRECORDER_MCP_SOCKET, and ALMRECORDER_MCP_TOKEN copied from AlmRecorder. The transport is local stdio and AlmRecorderMCPBridge takes no arguments.
7. Do not alter or delete any other client settings. Show a diff or describe exactly what changed.
8. Reload MCP servers or restart Cursor.
9. Ask the agent to call get_library_status and report the recording count. Then call list_recordings with limit: 1. Do not change anything.
10. Do not enable AlmRecorder’s content or write permissions. I will choose those myself after the read-only check succeeds.

ALMRECORDER COPIED CONFIGURATION:
[Paste Copy configuration from AlmRecorder here]

Prepare AlmRecorder

Keep AlmRecorder in Applications and open. On every sensitive recording, turn off Allow MCP clients to access this recording; use Hide from MCP on privacy tags. In Settings → MCP, leave content and changes permissions off, turn on Enable local MCP server, wait for Listening on …, and choose Copy configuration.

Get the connection values

The token is copied—not revealed

AlmRecorder intentionally masks the real token in the on-screen preview. There is no visible token field to hunt for.

1. Open Settings → MCP in AlmRecorder.
2. Turn on Enable local MCP server and wait until Status says Listening on ….
3. Choose Copy configuration. The clipboard now contains the command, socket, and real ALMRECORDER_MCP_TOKEN.

Paste the configuration directly where this guide tells you. Treat it like a password and clear the clipboard after the connection works.

1 Choose Copy configuration

Permission boundary: Allow content, notes, comments, summaries, and transcript search unlocks those reads. Allow tags, notes, and comments to be changed unlocks tag changes; notes and comments require both grants. Start with neither.

Add it to Cursor

Use Cursor’s global file at ~/.cursor/mcp.json. Do not put this token in a project-level .cursor/mcp.json, where it could be committed or shared.

If the global file is empty, paste the complete JSON copied from AlmRecorder. If it already contains servers, merge only the almrecorder entry into its existing mcpServers object:

{
  "mcpServers": {
    "almrecorder": {
      "command": "/Applications/AlmRecorder.app/Contents/MacOS/AlmRecorderMCPBridge",
      "env": {
        "ALMRECORDER_MCP_SOCKET": "/Users/you/Library/Application Support/AlmRecorder/MCP/mcp.sock",
        "ALMRECORDER_MCP_TOKEN": "paste the token copied from AlmRecorder"
      }
    }
  }
}

Save the file. Open Cursor Settings → Tools & MCP, find almrecorder, and enable or restart it. Reload the Cursor window if it does not appear.

Check the connection

In Agent mode, ask:

Use AlmRecorder’s get_library_status tool and report the recording count. Then call list_recordings with limit: 1. Do not change anything.

That first call must succeed while AlmRecorder remains open. Enable Content only for transcript work, and Writes only when you explicitly want Cursor to change supported data.

If it fails

• Red status: check that command points to the app’s current location and both environment values are present.
• Invalid JSON: keep one top-level mcpServers object and add commas between sibling server entries.
• Unauthorized or unavailable: re-enable AlmRecorder’s server and replace stale copied values.
• Works in one project only: move the entry to the global file and remove the token from the repository.

Remove the almrecorder entry and reload Cursor to disconnect it.

Cursor MCP documentation · Privacy in AlmRecorder · General troubleshooting