Best for
- Developers and investors who need quick access to Yahoo Finance data
- Users performing financial analysis, market research, and investment research with Claude
- Users who want to integrate financial data into MCP client workflows
Y
Yahoo Finance MCP Server
Community
Comprehensive Yahoo Finance data via the Model Context Protocol.
GitHub source repository ↗
47FMRS · D
This MCP server offers a rich set of Yahoo Finance data tools covering stock information, financial statements, options, and analyst recommendations. Installation is straightforward via uvx. Suitable for developers and investors needing quick financial data. However, it relies on third-party data sources which may be unstable, and data accuracy should be verified.
This is a Model Context Protocol (MCP) server that provides comprehensive financial data from Yahoo Finance. It allows you to retrieve detailed information about stocks, including historical prices, company information, financial statements, options data, and market news.
Tools
get_historical_stock_prices
Get historical OHLCV data for a stock with customizable period and interval.
get_stock_info
Get comprehensive stock data including price, metrics, and company details.
get_yahoo_finance_news
Get latest news articles for a stock.
get_stock_actions
Get stock dividends and splits history.
get_financial_statement
Get income statement, balance sheet, or cash flow statement (annual/quarterly).
get_holder_info
Get major holders, institutional holders, mutual funds, or insider transactions.
get_option_expiration_dates
Get available options expiration dates.
get_option_chain
Get options chain for a specific expiration date and type (calls/puts).
get_recommendations
Get analyst recommendations or upgrades/downgrades history.
Setup
- Ensure Python 3.11 or higher is installed.
- Run directly with uvx:
uvx --from git+https://github.com/Alex2Yang97/yahoo-finance-mcp yahoo-finance-mcp. - Or clone the repository and install locally:
git clone https://github.com/Alex2Yang97/yahoo-finance-mcp.git, enter the directory, create a virtual environment, and install dependencies. - For Claude Desktop, edit the config file to add the MCP server configuration above, then restart Claude Desktop.
claude_desktop_config.json
{
"mcpServers": {
"yfinance": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/Alex2Yang97/yahoo-finance-mcp",
"yahoo-finance-mcp"
]
}
}
}
Fit and risk
Not for
- Scenarios requiring real-time or ultra-low latency data (data comes from Yahoo Finance and may be delayed)
- Scenarios requiring official, authoritative, or verified financial data (data comes from Yahoo Finance and may be incomplete or inaccurate)
- Long-running stable servers, as it depends on third-party Yahoo Finance API which may be unstable
Required permissions
- No API key or additional permissions required; directly accesses Yahoo Finance public data.
- Communicates with MCP clients via standard I/O.
- Requires network access to Yahoo Finance to fetch data.
Risks and side effects
- Dependency on third-party Yahoo Finance service; data may be unavailable due to outages or API changes.
- Data may be delayed or inaccurate; use with caution for investment decisions.
- Rate limits may apply; high-frequency calls could lead to request rejection.
Troubleshooting
- Ensure network connectivity to Yahoo Finance is working.
- Ensure Python version meets the requirement (3.11+).
- Verify dependencies are correctly installed, especially yfinance and mcp.
- For Claude Desktop, ensure the uvx command is in PATH or use the full path.
- If tools produce no output, try restarting the MCP server.
Use cases
Show me the historical stock prices for AAPL over the last 6 months with daily intervals.
Get the quarterly balance sheet for Microsoft.
What are the key financial metrics for Tesla from the stock info?
Compare the quarterly income statements of Amazon and Google.
Show me the annual cash flow statement for NVIDIA.
Get the latest news articles about Meta Platforms.
Show me the institutional holders of Apple stock.
What are the recent insider transactions for Tesla?
Get the options chain for SPY with expiration date 2024-06-21 for calls.
What are the analyst recommendations for Amazon over the last 3 months?
Supported clients
Claude DesktopFull support