# Monologue

> Monologue is an open-source MCP server for productivity. One private feed of what your AI agents changed, readable and writable over MCP. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Web, API, self-hosted
- **Website:** https://www.monologue.events/developers
- **Repository:** https://github.com/willcheung/monologue
- **MCP Registry name:** io.github.willcheung/monologue
- **Categories:** productivity, developer tools
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://www.monologue.events/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "monologue": {
      "url": "https://www.monologue.events/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/monologue
