| name | monologue-notes-api |
| description | 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 MONOLOGUE_API_KEY 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.
|
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:
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
