# Monologue Notes Api

> Úsalo para leer o buscar notas de Monologue mediante su API REST: autenticación con MONOLOGUE_API_KEY, listado, paginación, filtros y manejo de errores, todo por HTTP directo con curl.

Fuente: https://skillsagentes.com/skills/intellectronica/agent-skills/monologue-notes-api
Markdown: https://skillsagentes.com/skills/intellectronica/agent-skills/monologue-notes-api.md

Repositorio: https://github.com/intellectronica/agent-skills
Autor: intellectronica
Licencia: CC0-1.0
Actualizado: hace 5 meses
Coste de contexto: 100 tok instalada, 1.4k tok al activarse, 1.4k tok con todos los archivos del bundle
Bundle: 1 archivo, 6 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add intellectronica/agent-skills --skill monologue-notes-api --agent claude-code
# Cursor
npx -y skills add intellectronica/agent-skills --skill monologue-notes-api --agent cursor
# Codex
npx -y skills add intellectronica/agent-skills --skill monologue-notes-api --agent codex
# Gemini CLI
npx -y skills add intellectronica/agent-skills --skill monologue-notes-api --agent gemini
# Windsurf
npx -y skills add intellectronica/agent-skills --skill monologue-notes-api --agent windsurf
# Cline
npx -y skills add intellectronica/agent-skills --skill monologue-notes-api --agent cline
```

## Qué hace

- Llama directamente a la API REST de Monologue Notes usando curl con el header Authorization: Bearer $MONOLOGUE_API_KEY
- Lista notas con paginación, filtros por fecha y búsqueda de texto completo con q
- Obtiene el detalle de una nota individual incluyendo transcript y transcript_segments
- Verifica si MONOLOGUE_API_KEY está definida sin mostrar su valor
- Maneja errores HTTP (400, 401, 403, 404, 422) sin exponer el token

## Cuándo usarla

- El usuario quiere leer o buscar sus notas de Monologue a través de la API REST
- Se necesita listar notas, obtener una nota concreta, paginar o filtrar por fecha
- Se requiere buscar notas por palabra clave en títulos, resúmenes o transcripciones

## Cuándo no

- El usuario pide operaciones de escritura, ya que la API es solo de lectura

## Qué la activa

- "Busca en mis notas de Monologue las que mencionen 'entrevista'"
- "Muéstrame el detalle de la nota NOTE_ID de Monologue"
- "Lista mis notas de Monologue creadas después del 1 de enero de 2026"
- "Página por todas mis notas de Monologue usando el cursor"

## Antes de instalar

- Requiere la variable de entorno MONOLOGUE_API_KEY con scope notes:read, y un cliente HTTP como curl.
- Necesita en el PATH: curl, jq
- Variables de entorno: MONOLOGUE_API_KEY
- makes network requests
- needs API credentials

## Archivos

- SKILL.md — 6 KB

## SKILL.md

Reproducido tal cual desde intellectronica/agent-skills bajo CC0-1.0. Esta sección es el documento original y está en inglés.

# 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 `Authorization` header as a shell variable expansion

Check whether the token is available without displaying it:

```bash
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:

```bash
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:

```bash
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 from `1` to `100`, default `20`
- `cursor`: opaque pagination cursor from a previous response
- `created_after`: ISO 8601 timestamp
- `created_before`: ISO 8601 timestamp
- `updated_after`: ISO 8601 timestamp
- `q`: full-text search across titles, summaries, and transcripts

Example:

```bash
curl -sS \
  -H "Authorization: Bearer $MONOLOGUE_API_KEY" \
  "https://api.monologue.to/v1/public-api/notes?limit=20&q=interview"
```

Example with `jq`:

```bash
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 summaries
- `next_cursor`: cursor for the next page, if any

Each list item may include:

- `note_id`
- `title`
- `summary`
- `created_at`
- `updated_at`

Possible errors:

- `400`: invalid filter or cursor
- `401`: missing or invalid token
- `403`: token lacks the required scope
- `422`: 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:

```bash
curl -sS \
  -H "Authorization: Bearer $MONOLOGUE_API_KEY" \
  "https://api.monologue.to/v1/public-api/notes/NOTE_ID"
```

Example with `jq`:

```bash
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:

- `transcript`
- `transcript_segments`

Notes:

- `transcript_segments` is loosely typed structured JSON and may be `null`
- `404` means the note was not found for the authenticated user

Possible errors:

- `401`: missing or invalid token
- `403`: token lacks the required scope
- `404`: note not found
- `422`: validation error

## Common Workflows

### Search notes by keyword

Use the `q` parameter:

```bash
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

1. Call `GET /v1/public-api/notes`
2. Read `next_cursor` from the response
3. Pass that cursor back as the `cursor` query parameter
4. Stop when `next_cursor` is absent or `null`

Example:

```bash
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:

```bash
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.to` for 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.json` on 2026-04-22

## Dónde encaja

- Categoría: [Desarrollo de APIs](https://skillsagentes.com/categorias/desarrollo-apis.md) — Diseña, prueba y documenta APIs HTTP y GraphQL.
- Creador: [intellectronica](https://skillsagentes.com/creators/intellectronica.md) — 22 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Gog Cli](https://skillsagentes.com/skills/intellectronica/agent-skills/gog-cli.md): Úsalo cuando el usuario quiera operar Google Workspace desde la línea de comandos con gog/gogcli: Gmail, Calendar, Drive, Docs, Sheets, Slides, Forms, Apps Script, Chat, Classroom, Contacts, Tasks, Groups, Admin, Keep y auth.
- [Copilot Sdk](https://skillsagentes.com/skills/intellectronica/agent-skills/copilot-sdk.md): Ayuda con el trabajo del GitHub Copilot SDK en Node.js/TypeScript, Python, Go, .NET y Java: setup, autenticación, permisos, streaming, tools personalizadas, custom agents, servidores MCP, hooks, skills y persistencia de sesiones.
- [Nano Banana 2](https://skillsagentes.com/skills/intellectronica/agent-skills/nano-banana-2.md): Genera y edita imágenes con Nano Banana 2 (Gemini 3.1 Flash Image Preview) de Google, para iteración rápida y control de aspect-ratio y resolución de 512px a 4K.
- [Here Be Git](https://skillsagentes.com/skills/intellectronica/agent-skills/here-be-git.md): Inicializa un repositorio git con instrucciones opcionales de commit para el agente y un .gitignore.
- [Todoist Api](https://skillsagentes.com/skills/intellectronica/agent-skills/todoist-api.md): Instrucciones para interactuar con Todoist mediante la CLI td: operaciones CRUD sobre tareas, proyectos, secciones, etiquetas y comentarios, con confirmación previa a acciones destructivas.

## Skills relacionadas

- [Copilot Sdk](https://skillsagentes.com/skills/intellectronica/agent-skills/copilot-sdk.md): Ayuda con el trabajo del GitHub Copilot SDK en Node.js/TypeScript, Python, Go, .NET y Java: setup, autenticación, permisos, streaming, tools personalizadas, custom agents, servidores MCP, hooks, skills y persistencia de sesiones.
- [Gpt Image 2](https://skillsagentes.com/skills/conardli/garden-skills/gpt-image-2.md): Generación y edición de imágenes con GPT Image 2, en 3 modos: Garden local (genera y guarda), Host-Native (prepara el prompt para la herramienta del anfitrión) o Advisor (solo entrega el prompt). 80+ plantillas en 18 categorías.
- [Raindrop Api](https://skillsagentes.com/skills/intellectronica/agent-skills/raindrop-api.md): Instrucciones completas para usar la API REST de Raindrop.io con curl y jq: autenticación, CRUD de colecciones, raindrops, tags, highlights, filtros, import/export y backups.
- [Ultrathink](https://skillsagentes.com/skills/intellectronica/agent-skills/ultrathink.md): Muestra arte ANSI colorido con la palabra "ultrathink". Se usa cuando el usuario escribe "ultrathink" o invoca /ultrathink.
- [Gog Cli](https://skillsagentes.com/skills/intellectronica/agent-skills/gog-cli.md): Úsalo cuando el usuario quiera operar Google Workspace desde la línea de comandos con gog/gogcli: Gmail, Calendar, Drive, Docs, Sheets, Slides, Forms, Apps Script, Chat, Classroom, Contacts, Tasks, Groups, Admin, Keep y auth.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)