Skip to content

monologueinc/monologue

v1.0.0MIT

Search, review, and share your Monologue voice notes with AI coding agents.

Monologue plugin

The official agent plugin for Monologue. Search, review, and share your private voice notes from Codex, Claude Code, Cursor, Grok, Gemini CLI, and any client that supports the Agent Plugins specification.

Monologue connects over OAuth to https://api.monologue.to/mcp. Every result is scoped to the authenticated Monologue account. The only write action is turning a note's public share link on or off, and it needs a separate permission you approve.

What it can do

  • List recent notes with pagination.
  • Search notes by text and date range.
  • Retrieve a note, optionally including its transcript.
  • Read a note someone shared with you or a public note opened by its share link.
  • Turn a note's public share link on or off, if you approve the notes:write permission.
  • Prepare for meetings, create follow-ups, and synthesize weekly reviews.

Install

Codex

codex plugin marketplace add MonologueInc/monologue-plugin
codex plugin add monologue@monologue

Claude Code

claude plugin marketplace add MonologueInc/monologue-plugin
claude plugin install monologue@monologue

Cursor

Install Monologue from the Cursor Marketplace when the listing is approved. For local development, clone this repository and symlink it into Cursor's plugin directory:

git clone https://github.com/MonologueInc/monologue-plugin.git
mkdir -p ~/.cursor/plugins
ln -s "$(pwd)/monologue-plugin" ~/.cursor/plugins/monologue

Grok

Install Monologue from the Grok plugin marketplace once the listing is approved. The Grok manifest is .grok-plugin/plugin.json; it uses the same skills, commands, and .mcp.json as Claude Code.

Gemini CLI

gemini extensions install https://github.com/MonologueInc/monologue-plugin

Gemini's extension gallery discovers this repository through the gemini-cli-extension GitHub topic.

Agent Plugins clients

The portable entry points are plugin.json and mcp.json.

Available MCP tools

ToolPurpose
list_recent_notesList the authenticated user's recent notes.
search_notesSearch the user's notes by text and optional date filters.
get_noteRetrieve one owner-scoped note and optionally its transcript.
get_shared_noteRead a note shared with the user, or a public note by its share link.
set_note_shareTurn a note's public share link on or off. Owner only; needs notes:write.

The plugin cannot create, edit, or delete notes. Sharing is the only change it can make, and only when the user asks for it.

Authentication and privacy

The first MCP request opens Monologue's browser-based OAuth flow. Reading needs the notes:read scope. Sharing needs notes:write, which you approve on the consent screen; without it, the share tool returns an error and nothing changes. offline_access keeps you signed in. Credentials are managed by the host client and are not stored in this repository. Revoke access at any time under Settings → Connected apps in the Monologue web app.

Development

make validate
make validate-network
claude plugin validate . --strict

Marketplace submission materials live in submission/. See CONTRIBUTING.md for release requirements.

License

MIT