Skip to content

Repository files navigation

Monologue plugin

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

Monologue connects over OAuth to https://api.monologue.to/mcp. The integration is read-only and every result is scoped to the authenticated Monologue account.

What it can do

  • List recent notes with pagination.
  • Search notes by text and date range.
  • Retrieve a note, optionally including its transcript.
  • Prepare for meetings, create follow-ups, and synthesize weekly reviews.

Install

Codex

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

Claude Code

claude plugin marketplace add EveryInc/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/EveryInc/monologue-plugin.git
mkdir -p ~/.cursor/plugins
ln -s "$(pwd)/monologue-plugin" ~/.cursor/plugins/monologue

Gemini CLI

gemini extensions install https://github.com/EveryInc/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

Tool Purpose
list_recent_notes List the authenticated user's recent notes.
search_notes Search the user's notes by text and optional date filters.
get_note Retrieve one owner-scoped note and optionally its transcript.

The plugin cannot create, edit, delete, or share notes.

Authentication and privacy

The first MCP request opens Monologue's browser-based OAuth flow. Access is limited to the notes:read scope. Credentials are managed by the host client and are not stored in this repository.

Development

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

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

License

MIT

About

Official Monologue plugin for Codex, Claude Code, Cursor, Gemini CLI, and Agent Plugins clients

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages