MCP.Market

Apple Stocks MCP server

by helderpgoncalves·io.github.helderpgoncalves/apple-stocks-mcp·v1.1.5·2 stars
No reviews yet

Reads your macOS Apple Stocks watchlist, quotes and fundamentals locally. Read-only, no network.

A92/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A92/100

full report

Adoption
Growing

2 stars70 downloads/wk

Reviews

Write one

Nobody has reviewed Apple Stocks yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Apple Stocks tools (12)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • add_stock

    Open a ticker in the macOS Apple Stocks app so it can be added to the watchlist with one click. Does NOT modify the app's database directly (which would risk corrupting it / iCloud sync). macOS only.

  • apple_stock

    Get full Apple (AAPL) fundamentals from the Apple Stocks app and report whether AAPL is in the watchlist. A convenience shortcut for 'the Apple stock'.

  • get_quote

    Get the price and daily change for one or more symbols, read from the Apple Stocks app's local cache. Symbols need not be in the watchlist.

  • list_watchlist

    List every ticker in the macOS Apple Stocks app watchlist, read directly from the app's local data. macOS only.

  • platform_info

    Report whether this server can run here. apple-stocks-mcp is macOS-only (it reads the Apple Stocks app's local data).

  • portfolio_summary

    Analyse the whole watchlist: how many are up/down, top gainers and losers today, and a breakdown by currency and exchange. All from the Apple Stocks cache.

  • quote_watchlist

    Get cached quotes for every symbol in the Apple Stocks watchlist, in order.

  • search_watchlist

    Search the watchlist by ticker symbol or company name (case-insensitive substring). Returns matching quotes from the Apple Stocks cache.

  • stock_chart

    Get the cached intraday price chart (OHLCV sparkline) for a symbol from the Apple Stocks app, with day range and change vs previous close.

  • stock_details

    Get full fundamentals for a symbol from the Apple Stocks cache: price, day & 52-week range, market cap, volume & average volume, P/E, EPS, beta, dividend yield and next earnings date.

  • stocks_doctor

    Check the environment: are you on macOS, is the Stocks app data present, is sqlite3 available, and can the data actually be read (catches Full Disk Access problems)? Use this when other tools error.

  • top_movers

    Show the biggest gainers and losers in the watchlist today, ranked by percentage change. Data from the Apple Stocks cache.

Public scan report

scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it

no findings
  • Code scan5 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 16 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Apple Stocks compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
92/100
higher than 95% of 48,255 servers
Tools
12
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
2
more than 75% of 28,688 servers
Downloads a week
70
more than 54% of 12,191 servers with a package

What its tools let an agent do: 11 read · 1 create

Install Apple Stocks in Claude Code, Cursor or VS Code

Runs npx -y apple-stocks-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add apple-stocks-mcp -- npx -y apple-stocks-mcp
Add to Cursor

What the publisher says

From the Apple Stocks repository's README, as published. We do not edit it. Read it on GitHub

🍎 apple-stocks-mcp

A macOS-only Model Context Protocol (MCP) server that lets an AI assistant read your own data from the Stocks app that ships with macOS — your watchlist, and the quotes, fundamentals and intraday charts the app has already cached on your Mac.

100% local and read-only. It reads files that already exist on your own machine, in the Stocks app's container under your home folder. It makes no network requests, uses no external API, needs no API keys, and sends nothing anywhere. The data is whatever the Stocks app last synced — open the app to refresh it.

⚠️ macOS only. The data lives inside the macOS Stocks app's container, so

this server does not work on Linux or Windows. On a non-macOS host the server

still starts, but exposes a single platform_info tool that politely explains

it's macOS-only and how to remove it — no failing tools, no crashes.

Quick start (30 seconds)

On a Mac, open the Stocks app once (so its data exists), then:

Claude Desktop / any MCP client — add this and restart:

{ "mcpServers": { "apple-stocks": { "command": "npx", "args": ["-y", "apple-stocks-mcp"] } } }

Claude Code:

claude mcp add apple-stocks -- npx -y apple-stocks-mcp

Then ask: "What's the Apple stock doing today?" The first time, your client asks permission to use the tool — choose Yes (or "Yes, and don't ask again"). That's it. If anything's off, ask it to run stocksdoctor** — it tells you exactly what to fix.

Contents

  • What you can ask
  • Privacy
  • Where the data comes from
  • Tools · Resources · Prompts
  • Example output
  • Requirements
  • Setup
  • FAQ & troubleshooting
  • Development & testing
  • Legal

What you can ask

Once connected (see Setup), ask your assistant things like:

  • "What's in my stock watchlist?"
  • "What's the Apple stock doing today?"
  • "Show me the fundamentals for NVDA."
  • "Which of my stocks are up the most today?"
  • "Summarize my whole watchlist."

Privacy

This is the most important section, so it's first.

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Apple Stocks: common questions

Is Apple Stocks MCP server safe?
Yes, by our scan: it is graded A (92/100). Read the Apple Stocks safety report
How do I install Apple Stocks?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Apple Stocks need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Apple Stocks maintained?
The last commit was 55 days ago (2026-09-10). The latest release is v1.1.5.
How does Apple Stocks compare with other MCP servers?
safety score 92/100 (higher than 95% of 48,255 servers); tools 12 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.