Cloud API and connectors

The Cloud API lets remote agents read your Anarlog meetings while the desktop app is closed. It requires Pro access, either from your personal plan or membership in an active paid Pro workspace, and stays off until you enable it.

Enabling Cloud API & Connectors uploads a separate server-readable copy of your meeting titles, notes, summaries, participants, action items, and transcripts. Your normal cloud sync data stays end-to-end encrypted. Turning the feature off deletes the server-readable copies.

Enable cloud access

Open Settings → Developers → Cloud API & Connectors.
Review the disclosure and turn the feature on.
Wait for Anarlog to upload your existing meetings.
If your client does not support OAuth, create a cloud API key and copy it. The key is shown once.

Keys start with anl_ and are stored hashed. Revoke a key from the same settings page when you no longer use it.

REST API

The base URL is https://api.anarlog.so/v1. Send your cloud key as a bearer token:

curl \
  -H "Authorization: Bearer anl_..." \
  https://api.anarlog.so/v1/meetings

The read endpoints are:

Endpoint	Returns
`GET /v1/meetings`	Meeting list. Accepts `query`, `series_id`, `limit` (default 20, clamped to `1..200`), and `offset`.
`GET /v1/meetings/{meeting_id}`	Meeting metadata, the canonical memo, summaries, participants, and action items. Memo and summary bodies are markdown.
`GET /v1/meetings/{meeting_id}/transcript`	Joined `text`, the raw `words`, and `pagination`. Accepts `offset` and `limit` (default 200, clamped to `1..500`).
`GET /v1/meetings/{meeting_id}/history`	Meetings in the same recurring series, newest first. Accepts `limit` and `offset`.
`GET /v1/meetings/{meeting_id}/export`	Full export including transcripts. `format=json` (default) or `format=markdown`.

List responses carry a pagination object with offset, limit, returned, total, and next_offset; a missing next_offset means the page reached the end. See the OpenAPI document for the complete hosted schema. Errors use this envelope:

{ "error": { "code": "not_found", "message": "meeting 'x' not found" } }

Codes: unauthorized, not_found, invalid_request, internal_error. The hosted API can also return:

403 subscription_required when the account does not have Pro access through a personal plan or an active paid Pro workspace membership.
403 cloud_api_not_enabled when the account has opted out.
429 with a plain-text rate limit exceeded body and retry-after header when you exceed the hosted request limit.

The request limit allows a burst of 10 requests per account, then refills one request every 200 milliseconds.

Meeting snapshots are limited to 2 MB. When a snapshot is larger, Anarlog removes word-level transcript timing before upload but keeps the transcript text. If the snapshot is still larger than 2 MB, that meeting cannot upload. A hosted transcript without word timing returns the retained text with an empty words array.

Remote MCP

The Streamable HTTP endpoint is:

https://api.anarlog.so/mcp

It exposes the same five meeting-read tools as the local MCP server:

list_meetings
get_meeting
get_meeting_transcript
get_recurring_meeting_history
export_meeting

Hosts that support MCP OAuth 2.1 connect your Anarlog account without a cloud API key. The host discovers Anarlog’s authorization server from the MCP endpoint, opens the Anarlog sign-in and consent flow, and stores the resulting connection. Anarlog does not use identity scopes as meeting permissions. Meeting access remains limited to the server-readable snapshots you explicitly opted in to upload. Every MCP tool is read-only, and every access token is checked for its signature, issuer, expiry, MCP resource audience, and OAuth client identifier. Anarlog publishes OAuth protected-resource metadata at:

https://api.anarlog.so/.well-known/oauth-protected-resource/mcp

The metadata points the host to Anarlog’s existing Supabase authorization server. That server uses dynamic client registration and PKCE with SHA-256. The host sends the MCP resource value during authorization and token exchange; Anarlog binds issued OAuth tokens to https://api.anarlog.so/mcp and rejects tokens minted for another resource.

OAuth does not bypass Anarlog’s product controls. The account must have Pro access through a personal plan or an active paid Pro workspace membership, and Cloud API & Connectors must remain enabled. Disabling the feature deletes the uploaded snapshots and makes existing connector tokens unusable for meeting access.

Claude Code

Install the Anarlog plugin:

claude plugin marketplace add fastrepl/anarlog
claude plugin install anarlog@fastrepl

Or add the remote server directly. Claude discovers OAuth from the MCP endpoint:

claude mcp add --transport http anarlog https://api.anarlog.so/mcp

Cursor

Import https://github.com/fastrepl/anarlog as a team marketplace and install Anarlog, or add this MCP server:

{
  "mcpServers": {
    "anarlog": {
      "url": "https://api.anarlog.so/mcp"
    }
  }
}

GitHub Copilot CLI

copilot plugin marketplace add fastrepl/anarlog
copilot plugin install anarlog@fastrepl

ChatGPT and Codex

Add the Fastrepl source, restart the ChatGPT desktop app, then install Anarlog:

codex plugin marketplace add fastrepl/anarlog \
  --sparse .agents/plugins \
  --sparse agent-plugins/anarlog

Public listing in a host’s plugin directory is a separate review step. Installing from the Fastrepl source does not submit or publish the connector.

Grok Bot

Grok Bot has no settings form for custom MCP servers. Add Anarlog from a Bot conversation:

Add this custom MCP server: https://api.anarlog.so/mcp

Confirm the server details when the bot asks, then finish the Anarlog sign-in and consent flow in your browser. The Anarlog tools are available from your next message. Grok Bot runs in the cloud, so it can only reach the hosted endpoint, not local MCP.

Instinct

Add https://api.anarlog.so/mcp as an MCP connection in your Instinct account and name it Anarlog. Complete the Anarlog sign-in and consent flow with the account that has Cloud API & Connectors enabled. If Instinct asks for a token instead of opening a sign-in page, create a personal cloud API key and paste it as the bearer token.

Other OAuth MCP clients

Choose Streamable HTTP and use https://api.anarlog.so/mcp as the server URL. Do not paste an API key. The client must follow MCP OAuth 2.1 protected-resource discovery.

API-key clients

Use a static bearer header only when the host cannot complete MCP OAuth. Create the key under Settings → Developers → Cloud API & Connectors.

Claude Code

claude mcp add --transport http anarlog https://api.anarlog.so/mcp \
  --header "Authorization: Bearer anl_..."

OpenAI Responses API

Pass the remote MCP URL and authorization header in the tool definition:

const response = await client.responses.create({
  model: "gpt-5",
  input: "Summarize my latest Anarlog meeting.",
  tools: [
    {
      type: "mcp",
      server_label: "anarlog",
      server_url: "https://api.anarlog.so/mcp",
      headers: {
        Authorization: "Bearer anl_...",
      },
      require_approval: "never",
    },
  ],
});

Muse

Meta Muse does not accept MCP servers. Instead, ask Muse to build a Custom Connector against the Anarlog REST API. Create a personal cloud API key named muse so you can revoke it separately, then send Muse:

Create a custom connector for Anarlog, my meeting notes. The base URL is
https://api.anarlog.so and the OpenAPI document is
https://api.anarlog.so/openapi.json. Only use the /v1/meetings operations.
Authenticate every request with the header "Authorization: Bearer <my key>".
It is read-only: list meetings, read a meeting, read its transcript, and
export it.

The OpenAPI paths already include the /v1 prefix, so the base URL is the bare host. Check that the first request Muse makes targets /v1/meetings, not /v1/v1/meetings. Muse stores the key in its Secure Credentials Store; Anarlog never sees your Muse account. The connector appears under Settings → Connectors in Muse. Meta does not review custom connectors, so keep the key to yourself.

Poke

Poke does not complete MCP OAuth. Create a personal cloud API key in Anarlog and paste it only into your own Poke recipe or connection.

Do not share that key, put it in a public recipe, or reuse one key across users.

Other MCP clients

Choose Streamable HTTP, use https://api.anarlog.so/mcp as the server URL, and add:

Authorization: Bearer anl_...

Disable cloud access

Turn off Cloud API & Connectors under Settings → Developers. Anarlog immediately deletes all server-readable meeting snapshots. Your local meetings and end-to-end encrypted cloud sync data are unchanged. Revoked keys cannot read snapshots. If you lose Pro access from both your personal plan and any paid Pro workspace memberships, existing cloud keys return subscription_required.

Getting started

Using Anarlog

AI and privacy

CLI and agents

Recipes

Reference

Help

Cloud API and connectors

Enable cloud access

REST API

Remote MCP

Claude Code

Cursor

GitHub Copilot CLI

ChatGPT and Codex

Grok Bot

Instinct

Other OAuth MCP clients

API-key clients

Claude Code

OpenAI Responses API

Muse

Poke

Other MCP clients

Disable cloud access

​Enable cloud access

​REST API

​Remote MCP

​Claude Code

​Cursor

​GitHub Copilot CLI

​ChatGPT and Codex

​Grok Bot

​Instinct

​Other OAuth MCP clients

​API-key clients

​Claude Code

​OpenAI Responses API

​Muse

​Poke

​Other MCP clients

​Disable cloud access

Enable cloud access

REST API

Remote MCP

Claude Code

Cursor

GitHub Copilot CLI

ChatGPT and Codex

Grok Bot

Instinct

Other OAuth MCP clients

API-key clients

Claude Code

OpenAI Responses API

Muse

Poke

Other MCP clients

Disable cloud access