Skip to content
MCP server

Earnings Watch

Verified issuer earnings calendars and results-document links, with evidence for each date

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.3.3
Listing updated
today

Similar MCP servers

About Earnings Watch

Earnings Watch is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add earnings-watch -- uvx earnings-watch

Add to claude_desktop_config.json

{
  "mcpServers": {
    "earnings-watch": {
      "command": "uvx",
      "args": [
        "earnings-watch"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "earnings-watch": {
      "command": "uvx",
      "args": [
        "earnings-watch"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

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

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Open source, installed with uv or Docker

Earnings Watch 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.

How AIPoweredBot checks servers