Monologue Notes

Monologue Notes

Use this skill when an agent needs read-only access to Monologue Notes through the public API.

The current public surface is:

• GET /v1/public-api/notes
• GET /v1/public-api/notes/{note_id}

This skill is intentionally shell-first so it works across agents that can run terminal commands, including Codex and Claude Code.

Setup

If the monologue CLI is missing, install it:

curl -fsSL https://raw.githubusercontent.com/EveryInc/monologue-toolkit/main/install.sh | sh

If credentials are not configured yet, run onboarding:

monologue onboarding

During onboarding, ask the user to create a Monologue Notes API token in the Monologue app and paste it into the terminal. The CLI saves it for future use.

For a non-interactive agent flow, the agent can ask the user for the token in chat and then run:

monologue onboarding --token "mono_pat_..."

Commands

Use the CLI directly:

monologue notes list --limit 10
monologue notes list --q "customer interview"
monologue notes all --updated-after 2026-01-01T00:00:00Z
monologue notes get note_123
monologue notes get note_123 --field transcript

Workflow

1. If the CLI is missing, install it. 2. If the user is not onboarded yet, run monologue onboarding. 3. Use list to find relevant notes. 4. Use all when the request spans more than one page. 5. Use get NOTE_ID for the full note payload. 6. Use --field transcript or --field summary when only one field is needed.

Response style

• Prefer a short digest over raw JSON when the user asks for recent notes or summaries.
• Keep note_id internal unless the user explicitly asks for IDs or a follow-up action needs one.
• Surface titles, dates, summaries, and transcript highlights first.

References

• Read references/api.md for the exact published schema.
• Read references/install.md when the CLI is missing or the environment needs setup help.

Guardrails

• This skill is read-only. Do not invent create, update, or delete endpoints.
• Use ISO 8601 timestamps for created-after, created-before, and updated-after.
• Prefer the CLI over ad hoc curl so auth, errors, and pagination stay consistent.
• Skill installation itself should not be treated as a post-install execution hook. Install the CLI and run onboarding on first use instead.

Monologue Public Notes API

Source: https://api.monologue.to/public-openapi.json Fetched: 2026-04-06

Authentication

• Security scheme: HTTP bearer token
• Recommended base URL: https://api.monologue.to

Header:

Authorization: Bearer YOUR_PERSONAL_API_TOKEN

Endpoints

GET /v1/public-api/notes

Query parameters:

• limit integer, default 20, min 1, max 100
• cursor string, opaque pagination cursor
• created_after ISO 8601 date-time
• created_before ISO 8601 date-time
• updated_after ISO 8601 date-time
• q string, searches note titles, summaries, and transcripts

Success shape:

{
  "items": [
    {
      "note_id": "string",
      "title": "string or null",
      "summary": "string or null",
      "created_at": "2026-04-06T00:00:00Z",
      "updated_at": "2026-04-06T00:00:00Z"
    }
  ],
  "next_cursor": "string or null"
}

GET /v1/public-api/notes/{note_id}

Returns the full note payload. The public response adds:

• transcript
• transcript_segments

Notes

• The public Notes API is currently read-only.
• Pagination is cursor based.
• transcript_segments should be treated as loosely typed JSON.

Installing and onboarding the Monologue CLI

Preferred

Install from GitHub Releases:

curl -fsSL https://raw.githubusercontent.com/EveryInc/monologue-toolkit/main/install.sh | sh

Alternative

Install with Go:

go install github.com/EveryInc/monologue-toolkit/cli/cmd/monologue@latest

Onboarding

monologue onboarding

For agent-driven or non-interactive setup:

monologue onboarding --token "mono_pat_..."

The CLI stores credentials in your user config directory under monologue/config.json.

Environment overrides still work when needed:

export MONOLOGUE_API_TOKEN="mono_pat_..."
export MONOLOGUE_API_BASE_URL="https://api.monologue.to"