Skip to content
MCP server

Monologue

One private feed of what your AI agents changed, readable and writable over MCP

Install
Pricing
Open source
Platforms
Web, API, self-hosted
Runs
Remotely
Version
0.1.1
Listing updated
1 day ago

About Monologue

Monologue is an open-source MCP server for productivity. It runs as a hosted remote server, so there is nothing to install locally.

Monologue keeps a timeline of actions your agents took that changed something: emails sent, forms submitted, purchases made, code pushed, calendar events altered. Research, browsing and reasoning are deliberately left out, so the feed stays strict about signal; reading fifty messages does not count but sending one does.

Over MCP the connection uses OAuth. You choose a feed during sign-in and approve reading and reporting together, and access follows your membership in that workspace. Agents report actions with fields such as verb, summary, category, status and target system, and repeats are de-duplicated by external ID. A portable skill file keeps the reporting instructions in later sessions.

The code is open source and can run as a single-user instance with SQLite and a private ingestion key, with an optional multi-user cloud mode for your own deployment. A small Python helper can report actions without MCP. Setup needs Node.js 22.12 or newer.

Install

Run in a terminal

claude mcp add --transport http monologue https://www.monologue.events/mcp

Add to Settings → Connectors → Add custom connector

https://www.monologue.events/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "monologue": {
      "url": "https://www.monologue.events/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "monologue": {
      "type": "http",
      "url": "https://www.monologue.events/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "monologue": {
      "serverUrl": "https://www.monologue.events/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "monologue": {
      "type": "http",
      "url": "https://www.monologue.events/mcp"
    }
  }
}

What it does

Action feed
One timeline of changes agents made across different products.
Strict signal rule
Records changes only, not research, browsing or internal reasoning.
OAuth connection
Approve reading and reporting for a chosen workspace feed.
Duplicate handling
Resending an action with the same external ID returns the existing record.
Reporting skill
A portable skill keeps reporting instructions available across sessions.
Self-hosting
Run a single-user instance with a local SQLite database.

Good for

  • Review everything a coding agent pushed or changed in a day
  • Keep one audit trail across several agents
  • Check whether an agent really sent an email or submitted a form
  • Give a team a shared feed of agent activity

Pricing

Open source

Open source; hosted pricing not published

Prices change. Check monologue.events before you buy.

Monologue FAQ

What gets recorded?

Only things an agent changed, such as messages sent, code pushed to a remote, purchases made or calendar events changed.

Can I self-host it?

Yes. The repository runs locally with SQLite and a private API key, and no hosted account is required in single-user mode.

How does an agent connect?

Through the OAuth MCP endpoint, or by POSTing to the API with a bearer key.

What are the requirements?

Node.js 22.12 or newer and npm for running it yourself.

Is Monologue free?

Yes. Monologue is open source, so you can use and self-host it for free.

How do I add Monologue to Claude Code?

Run this command in your terminal: claude mcp add --transport http monologue https://www.monologue.events/mcp

What are the best alternatives to Monologue?

The closest alternatives to Monologue are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Monologue

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity