Earnings Watch
Verified issuer earnings calendars and results-document links, with evidence for each date
- 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-watchAdd to claude_desktop_config.json
{
"mcpServers": {
"earnings-watch": {
"command": "uvx",
"args": [
"earnings-watch"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"earnings-watch": {
"command": "uvx",
"args": [
"earnings-watch"
]
}
}
}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.


