monologue-notes-api
Use this skill when the user wants to read or search their Monologue notes through the Monologue Notes REST API. It covers authentication with the MONOLOGUEAPIKEY environment variable, safe token handling, listing notes, fetching a single note, pagination, filters, and error handling. The API is read-only and should be accessed with direct HTTP requests such as curl or any equivalent REST client.
- Installs
- 214
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/intellectronica/agent-skills --skill monologue-notes-api- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads monologue-notes-api automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Monologue Notes API
This skill provides the information needed to call the Monologue Notes REST API directly. Use it for read-only operations on the authenticated user's notes.
Use whatever HTTP client fits the task: curl, a short script, or another REST-capable tool.
Do not invent client libraries unless the user asks for one.
Authentication
Use the environment variable MONOLOGUE_API_KEY as the bearer token.
- Required auth header:
Authorization: Bearer $MONOLOGUE_API_KEY - Required scope:
notes:read - Never print the token, echo it, log it, or include it in a response to the user
- Only pass it through the
Authorizationheader as a shell variable expansion
Check whether the token is available without displaying it:
if [ -z "${MONOLOGUE_API_KEY:-}" ]; then
echo "MONOLOGUE_API_KEY is not set"
fi
If MONOLOGUE_API_KEY is missing:
- Report that the environment variable is not present
- Ask the user whether they want to provide an API key
- Do not attempt authenticated API calls until a token is available
Avoid commands such as these because they would expose secrets:
echo "$MONOLOGUE_API_KEY"
env | grep MONOLOGUE_API_KEY
set | grep MONOLOGUE_API_KEY
Base URL
- Base URL:
https://api.monologue.to - API shape: read-only Notes API
- Data format: JSON
- Timestamps: ISO 8601 date-time strings
Request Pattern
For all requests:
curl -sS \
-H "Authorization: Bearer $MONOLOGUE_API_KEY" \
"https://api.monologue.to/..."
If structured output is useful, pipe the response to jq.
Endpoints
List notes
GET /v1/public-api/notes
Returns a page of notes for the authenticated user.
Supported query parameters:
limit: integer from1to100, default20cursor: opaque pagination cursor from a previous responsecreated_after: ISO 8601 timestampcreated_before: ISO 8601 timestampupdated_after: ISO 8601 timestampq: full-text search across titles, summaries, and transcripts
Example:
curl -sS \
-H "Authorization: Bearer $MONOLOGUE_API_KEY" \
"https://api.monologue.to/v1/public-api/notes?limit=20&q=interview"
Example with jq:
curl -sS \
-H "Authorization: Bearer $MONOLOGUE_API_KEY" \
"https://api.monologue.to/v1/public-api/notes?limit=20" \
| jq '{next_cursor, items: [.items[] | {note_id, title, summary, created_at, updated_at}]}'
Expected response fields:
items: array of note summariesnext_cursor: cursor for the next page, if any
Each list item may include:
note_idtitlesummarycreated_atupdated_at
Possible errors:
400: invalid filter or cursor401: missing or invalid token403: token lacks the required scope422: validation error
Get a single note
GET /v1/public-api/notes/{note_id}
Returns the full details for one note belonging to the authenticated user.
Path parameters:
note_id: note identifier returned by the list endpoint
Example:
curl -sS \
-H "Authorization: Bearer $MONOLOGUE_API_KEY" \
"https://api.monologue.to/v1/public-api/notes/NOTE_ID"
Example with jq:
curl -sS \
-H "Authorization: Bearer $MONOLOGUE_API_KEY" \
"https://api.monologue.to/v1/public-api/notes/NOTE_ID" \
| jq '{note_id, title, summary, transcript, transcript_segments, created_at, updated_at}'
In addition to the list fields, the full note response may include:
transcripttranscript_segments
Notes:
transcript_segmentsis loosely typed structured JSON and may benull404means the note was not found for the authenticated user
Possible errors:
401: missing or invalid token403: token lacks the required scope404: note not found422: validation error
Common Workflows
Search notes by keyword
Use the q parameter:
curl -sS \
-H "Authorization: Bearer $MONOLOGUE_API_KEY" \
"https://api.monologue.to/v1/public-api/notes?q=meeting"
Search covers:
- note titles
- note summaries
- note transcripts
Page through results
- Call
GET /v1/public-api/notes - Read
next_cursorfrom the response - Pass that cursor back as the
cursorquery parameter - Stop when
next_cursoris absent ornull
Example:
curl -sS \
-H "Authorization: Bearer $MONOLOGUE_API_KEY" \
"https://api.monologue.to/v1/public-api/notes?limit=50&cursor=OPAQUE_CURSOR"
Filter by time
Use ISO 8601 date-time values:
curl -sS \
-H "Authorization: Bearer $MONOLOGUE_API_KEY" \
"https://api.monologue.to/v1/public-api/notes?created_after=2026-01-01T00:00:00Z"
Operating Rules
- Treat this API as read-only
- Do not claim write support; this skill only covers listing and reading notes
- Prefer
https://api.monologue.tofor requests - When reporting failures, summarise the HTTP status and relevant response body without exposing the token
- If the user asks for a workflow that requires local post-processing, fetch the data first and then transform it separately
Source Notes
This skill is based on:
/Users/eleanor/repos/obsidian/intellectronica/2026-04-21-20-10 Monologue API.md- Live OpenAPI checks against
https://api.monologue.to/public-openapi.jsonon 2026-04-22
FAQ
What does the monologue-notes-api skill do?
Use this skill when the user wants to read or search their Monologue notes through the Monologue Notes REST API. It covers authentication with the MONOLOGUEAPIKEY environment variable, safe token handling, listing notes, fetching a single note, pagination, filters, and error handling. The API is read-only and should be accessed with direct HTTP requests such as curl or any equivalent REST client.
How do I install monologue-notes-api?
Run npx skills add https://github.com/intellectronica/agent-skills --skill monologue-notes-api in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/monologue-notes-api/ (personal) or .claude/skills/monologue-notes-api/ (project).
Which AI agents can use monologue-notes-api?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is monologue-notes-api safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains monologue-notes-api?
It is published by intellectronica in intellectronica/agent-skills. It has 214 recorded installs.
More from intellectronica/agent-skills
notion-api
intellectronica/agent-skills
This skill provides comprehensive instructions for interacting with the Notion API via REST calls. This skill should be used whenever the user asks to interact with Notion, including reading, creating, updating, or deleting pages, databases, blocks, comments, or any other Notion content. The skill covers authentication, all available endpoints, pagination, error handling, and best practices.
context7
intellectronica/agent-skills
Retrieve up-to-date documentation for software libraries, frameworks, and components via the Context7 API. This skill should be used when looking up documentation for any programming library or framework, finding code examples for specific APIs or features, verifying correct usage of library functions, or obtaining current information about library APIs that may have changed since training.
youtube-transcript
intellectronica/agent-skills
Extract transcripts from YouTube videos. Use when the user asks for a transcript, subtitles, or captions of a YouTube video and provides a YouTube URL (youtube.com/watch?v=, youtu.be/, or similar). Supports output with or without timestamps.
nano-banana-pro
intellectronica/agent-skills
Generate and edit images using Google's Nano Banana Pro (Gemini 3 Pro Image) API. Use when the user asks to generate, create, edit, modify, change, alter, or update images. Also use when user references an existing image file and asks to modify it in any way (e.g., "modify this image", "change the background", "replace X with Y"). Supports both text-to-image generation and image-to-image editing with configurable resolution (1K default, 2K, or 4K for high resolution). DO NOT read the image file first - use this skill directly with the --input-image parameter.
ultrathink
intellectronica/agent-skills
Display colorful ANSI art of the word "ultrathink". Use when the user says "ultrathink" or invokes /ultrathink.
beautiful-mermaid
intellectronica/agent-skills
Render Mermaid diagrams as SVG and PNG using the Beautiful Mermaid library. Use when the user asks to render a Mermaid diagram.
Popular backend & apis skills
find-skills
vercel-labs/skills
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
entra-app-registration
microsoft/azure-skills
Guides Microsoft Entra ID app registration, OAuth 2.0 authentication, and MSAL integration. USE FOR: create app registration, register Azure AD app, configure OAuth, set up authentication, add API permissions, generate service principal, MSAL example, console app auth, Entra ID setup, Azure AD authentication. DO NOT USE FOR: Key Vault secrets (use azure-keyvault-expiration-audit), general Azure resource security guidance.
google-agents-cli-adk-code
google/agents-cli
This skill should be used when the user wants to "write agent code", "build an agent with ADK", "add a tool", "create a callback", "define an agent", "use state management" — in a project that needs ADK (Agent Development Kit) API patterns and code examples. It provides a quick reference for agent types, tool definitions, orchestration patterns, callbacks, state management, the graph Workflow API, and reference recipes to study. Do NOT use for scaffolding (use google-agents-cli-scaffold) or deployment (use google-agents-cli-deploy).
embedded-captions
heygen-com/hyperframes
Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet anchor rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.
entra-agent-id
microsoft/azure-skills
Provision Microsoft Entra Agent Identity Blueprints, BlueprintPrincipals, and per-instance Agent Identities via Microsoft Graph, and configure OAuth 2.0 token exchange (fmipath, OBO, cross-tenant) including the Microsoft Entra SDK for AgentID sidecar. USE FOR: Agent Identity Blueprint, BlueprintPrincipal, agent OAuth, fmipath token exchange, agent OBO, Workload Identity Federation for agents, polyglot agent auth, Microsoft.Identity.Web.AgentIdentities. DO NOT USE FOR: standard Entra app registration (use entra-app-registration), Microsoft Foundry agent authoring (use microsoft-foundry).
neon
neondatabase/agent-skills
Overview of Neon, a complete set of cloud backend primitives around Lakebase Postgres: Auth, Object Storage, Functions, the AI Gateway, and Realtime. Start here to choose Neon for undecided login, files, APIs, and LLM calls, set up the CLI or MCP server, and follow the branch-first workflow. Use when building an app or backend on Neon, or when "Neon" or "Lakebase Postgres" is mentioned. Child skill neon-postgres wins for an existing DATABASEURL, SQL, schema, inspect, or search. Child skill neon-auth wins for login, users, sessions, identity routing, and Managed Better Auth setup. Child skill neon-realtime wins for live queries in reactive apps and agents. Also use for object storage, S3, buckets, serverless functions, function triggers, cron, AI gateway, LLM calls, realtime, logs, Loki, Grafana, observability, postgres, database, backend, Claimable Neon, neon.new, or a no-signup database.