danishashko/yahoo-finance-mcp

Free Yahoo Finance MCP server with no API key. 18 read-only tools give Claude, Claude Code, Cursor, VS Code, Windsurf, Codex, n8n or any other MCP client live stock quotes, historical prices, financial statements, earnings dates and calendars, analyst ratings and estimates, options chains, insider and institutional holders, stock screeners, ETF and fund holdings, sector overviews and market news. Runs locally with one npx command, over stdio or Streamable HTTP.
> npm package: yahoo-finance-mcp-server  ·  GitHub repo: danishashko/yahoo-finance-mcp. The repo name is shorter than the package name; both refer to this project.
## 🎯 What You Get
📊 Real-time stock quotes with full market data
📈 Historical prices (OHLCV) with summary statistics
🏢 Company profiles, officers, and key statistics
💰 Financial statements (income, balance sheet, cash flow)
🎯 Analyst ratings, price targets, and the recent recommendation trend
⚖️ Multi-stock comparisons side by side
📰 Latest financial news per ticker
🧾 Options chains (calls/puts, strikes, IV, open interest)
🏦 Ownership data — institutional, mutual fund, and insider activity
💵 Dividend & split history
🔮 Forward analyst estimates (price targets, EPS/revenue, growth)
🔎 Symbol search by company name or keyword
🕒 Market status (open/closed) and index summary
📅 Earnings dates: next report, beat/miss history, and a market-wide earnings calendar
🧲 Stock screeners: day gainers/losers, most active, most shorted, undervalued growth, top ETFs
🧺 ETF and fund data: holdings, expense ratio, sector weights
🏭 Sector and industry overviews with their largest, fastest-growing and best-performing companies
Every tool returns human-readable markdown by default, or structured JSON on request (responseformat: "json"). Requests share a single browser-impersonating HTTP session to reduce Yahoo Finance rate-limiting.
## 🚀 Quick Start
Add this to your Claude Desktop config and restart Claude:
macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
Windows: %APPDATA%\Claude\claudedesktopconfig.json
json
"mcpServers": {
"yahoo-finance": {
"command": "npx",
"args": ["-y", "yahoo-finance-mcp-server"]
That is it. On first launch the npx wrapper creates an isolated Python environment and installs the dependencies for you (a one-time step that can take a minute). You only need Python 3.10+ and Node.js 16+ on your machine.
### Other clients
Claude Code
bash
claude mcp add yahoo-finance -- npx -y yahoo-finance-mcp-server
Cursor (~/.cursor/mcp.json), Windsurf (~/.codeium/windsurf/mcpconfig.json) and Gemini CLI (~/.gemini/settings.json) take the same mcpServers block as Claude Desktop above.
VS Code (.vscode/mcp.json)
json
"servers": {
"yahoo-finance": {
"type": "stdio",
"command": "npx",
"args": ["-y", "yahoo-finance-mcp-server"]
Codex CLI (~/.codex/config.toml)
toml
[mcpservers.yahoo-finance]
command = "npx"
args = ["-y", "yahoo-finance-mcp-server"]
n8n and other URL-only clients: see HTTP mode.
### Prefer a global install?
bash
npm install -g yahoo-finance-mcp-server
json
"mcpServers": {
"yahoo-finance": {
"command": "yahoo-finance-mcp-server"
## 🌐 HTTP mode (n8n, remote agents, anything that connects to a URL)