# Earnings Watch

> Earnings Watch is an open-source MCP server for finance and payments. Verified issuer earnings calendars and results-document links, with evidence for each date. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/benjamin-di/earnings-watch
- **MCP Registry name:** io.github.benjamin-di/earnings-watch
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-18

## About

Earnings Watch keeps a local SQLite catalogue of issuers' earnings dates and results documents and serves it over a CLI, a Python API and a stdio MCP server. Models propose dates, but deterministic checks require quoted evidence and consistent issuer, period and timing, and a call time never silently becomes a publication time. Exact times need verified clock and timezone evidence, otherwise calendar entries are all-day.

The serving process only reads SQLite and updates personal follows and ledgers. It never fetches issuer pages or calls a model, because maintenance runs separately through sweep and worker commands. The default model backend is none, and optional date extraction uses a Claude Code or Codex CLI the user has signed into. There is no bundled issuer universe or market-data subscription, so sources must be imported.

Ten tools cover upcoming dates, events with evidence and revisions, document links with verification status, a change feed, a watchlist and calendar planning. Outlook calendar sync is delegated to the client's own Outlook app, with no Microsoft credentials in the package and no attendees added. It requires Python 3.12 or newer and also offers Docker Compose and per-person HTTP tokens.

## Features

- **Evidence-backed dates:** Dates need quoted evidence and consistent issuer, period and timing.
- **Results documents:** Official document links with verification status.
- **Change feed:** Cursor-based feed of public changes.
- **Personal watchlist:** Follow issuers and manage registration states.
- **Outlook plan:** Produces a calendar operation plan for your own Outlook app.
- **Model-optional:** Runs with no model, or your own Claude Code or Codex CLI.

## Good for

- List upcoming earnings dates with timing uncertainty
- Check whether a results document is verified
- Sync a watchlist to an Outlook calendar
- Follow a company and get changes

## Install

### Claude Code (Terminal)

```sh
claude mcp add earnings-watch -- uvx earnings-watch
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "earnings-watch": {
      "command": "uvx",
      "args": [
        "earnings-watch"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "earnings-watch": {
      "command": "uvx",
      "args": [
        "earnings-watch"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "earnings-watch": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "earnings-watch"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "earnings-watch": {
      "command": "uvx",
      "args": [
        "earnings-watch"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "earnings-watch": {
      "command": "uvx",
      "args": [
        "earnings-watch"
      ]
    }
  }
}
```

## Tools

- `earnings_upcoming`: Bounded upcoming dates with timing uncertainty.
- `earnings_get_events`: Evidence, revisions and recent history.
- `earnings_documents`: Official result-document links and verification status.
- `earnings_changes`: Cursor-based public change feed.
- `earnings_watchlist`: Your follows and registration states.
- `earnings_watch`: Follow an issuer.
- `earnings_unwatch`: Remove a manual follow.
- `earnings_calendar_plan`: Plan optional external calendar operations.
- `earnings_calendar_ack`: Record confirmed operations from a signed plan.
- `earnings_status`: Catalogue and maintenance status.

## FAQ

### Does the server call a model?

No. Serving reads SQLite; maintenance runs separately.

### What do I need?

Python 3.12 or newer and imported issuer sources; there is no bundled issuer list.

### Are exact times guaranteed?

Only with verified clock and timezone evidence; otherwise entries are all-day.

### Does it need Microsoft credentials?

No, calendar changes go through your client's Outlook app.

### Is Earnings Watch free?

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

### How do I add Earnings Watch to Claude Code?

Run this command in your terminal: claude mcp add earnings-watch -- uvx earnings-watch

### What are the best alternatives to Earnings Watch?

The closest alternatives to Earnings Watch are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, dashboard-icons, Solana MCP by Vybe and Tapetide - Indian Stock Market MCP.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [dashboard-icons](https://ai-powered.com/mcp/dashboard-icons): dashboard-icons is an open-source MCP server for analytics and data.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [DataArcus for Power BI](https://ai-powered.com/mcp/dataarcus-for-power-bi): DataArcus for Power BI is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/earnings-watch
