yahoo-finance-mcp

Overview

This MCP server provides access to comprehensive financial data from Yahoo Finance through a well-structured interface. It offers tools for retrieving historical stock prices, company information, financial statements, options data, and market news. The server is actively maintained with recent commits and includes clear documentation for integration with Claude Desktop.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_historical_stock_prices

  Get historical OHLCV data for a stock with customizable period and interval

  Try:Show me the historical stock prices for AAPL over the last 6 months with daily intervalsTry:Get the historical price data for TSLA from January 2023 to December 2023
• get_stock_info

  Get comprehensive stock data including price, metrics, and company details

  Try:Get the key financial metrics for TeslaTry:Show me detailed information about Apple stock
• get_yahoo_finance_news

  Get latest news articles for a stock

  Try:Get the latest news articles about Meta PlatformsTry:Show me recent news for Microsoft
• get_stock_actions

  Get stock dividends and splits history

  Try:Show me the dividend history for Coca-ColaTry:Get information about stock splits for Apple
• get_financial_statement

  Get income statement, balance sheet, or cash flow statement (annual/quarterly)

  Try:Get the quarterly balance sheet for MicrosoftTry:Show me Amazon's annual income statement
• get_holder_info

  Get major holders, institutional holders, mutual funds, or insider transactions

  Try:Show me the institutional holders of Apple stockTry:What are the recent insider transactions for Tesla?
• get_option_expiration_dates

  Get available options expiration dates

  Try:Show me the available options expiration dates for SPYTry:Get expiration dates for options contracts on QQQ
• get_option_chain

  Get options chain for a specific expiration date and type (calls/puts)

  Try:Get the options chain for SPY with expiration date 2024-06-21 for callsTry:Show me the put options for TSLA expiring in 30 days
• get_recommendations

  Get analyst recommendations or upgrades/downgrades history

  Try:What are the analyst recommendations for Amazon?Try:Show me the recent upgrades and downgrades for tech stocks

Comparable tools

Installation

uvx --from git+https://github.com/Alex2Yang97/yahoo-finance-mcp yahoo-finance-mcp

{
  "mcpServers": {
    "yfinance": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/Alex2Yang97/yahoo-finance-mcp",
        "yahoo-finance-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "yfinance": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/Alex2Yang97/yahoo-finance-mcp",
        "yahoo-finance-mcp"
      ]
    }
  }
}

FAQ

What data sources does this MCP server use?

The server uses Yahoo Finance as its primary data source, retrieving information through the yfinance library.

Can I get real-time stock prices with this server?

The server provides historical stock prices and current market data, but real-time prices may have slight delays as they're sourced from Yahoo Finance.

Compare yahoo-finance-mcp with