MCP Directory

How to add Yahoo Finance MCP Server to Claude Desktop

Query stock data, news, financials, options, and generate charts from Yahoo Finance via yfinance. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 158★ · stdio · no auth

Claude Desktop config for Yahoo Finance MCP Server

uvx yfmcp@latest
{
  "mcpServers": {
    "yahoo-finance-mcp-server": {
      "command": "uvx",
      "args": [
        "yfmcp@latest"
      ]
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the Yahoo Finance MCP Server config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm Yahoo Finance MCP Server's tools appear under the 🔌 tools menu.

Before you start

  • Python >= 3.12
  • uv package manager (for the recommended uvx/uv install) or Docker

What Yahoo Finance MCP Server can do in Claude Desktop

yfinance_get_ticker_info

Retrieve comprehensive stock data including company info, financials, valuation metrics, trading info, dividends, and governance data for a given symbol.

yfinance_get_ticker_news

Fetch recent news articles and press releases for a specific stock, returned as a JSON array with title, summary, publication date, provider, URL, and thumbnail.

yfinance_search

Search Yahoo Finance for stocks, ETFs, and news articles; search_type can be 'all', 'quotes', or 'news'.

yfinance_get_top

Get top-ranked financial entities within a market sector (top_etfs, top_mutual_funds, top_companies, top_growth_companies, or top_performing_companies).

yfinance_screen

Run Yahoo Finance screeners using predefined screener keys (e.g. 'day_gainers') or custom equity/fund query trees with operator/operands nodes.

yfinance_screen_gappers

Run a purpose-built custom screener for opening-session bullish gappers, filterable by percent change, price, volume, market cap, and region.

yfinance_get_price_history

Fetch historical OHLCV price data over a period/interval as a markdown table, or generate a price_volume, vwap, or volume_profile chart returned as a Base64-encoded WebP image.

yfinance_get_financials

Fetch income statement, balance sheet, and cash flow statements with historical data at annual, quarterly, or ttm frequency.

Yahoo Finance MCP Server + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Yahoo Finance MCP Server config there under the "mcpServers" key and restart the client.

Does it require an API key?

No. The server pulls public data via the yfinance library, so no authentication or API key is configured in the README.

How are charts returned?

When a chart_type is requested on yfinance_get_price_history, the server returns a Base64-encoded WebP image for efficient token usage; otherwise price data comes back as a markdown table.

How do I run it?

Add it to your MCP client config with command 'uvx' and args ['yfmcp@latest'] (recommended), or use the Docker image narumi/yfinance-mcp, or run from a cloned source checkout with uv.

View repo Full Yahoo Finance MCP Server page