<div align="center"> <img src="screenshots/banner.png" alt="StockDock — track stocks from your macOS menu bar" width="100%">

StockDock

A free, open-source macOS menu bar app for tracking stocks, ETFs, indices, crypto, and your portfolio P&L in real time.

No account. No API keys. No subscription. No tracking. Just your watchlist and portfolio, always one click away in the menu bar.

<br>

<br>

brew install simonsruggi/tap/stockdock

🌐 Website · ⬇️ Download · ✨ Features · 📸 Screenshots · ❤️ Sponsor · ☕️ Coffee · 🐛 Report a bug · 📝 Changelog

</div>

---

⭐️ Using StockDock? It's free and there's no tracking, so a GitHub star is the only way I know anyone's out there. If the app is useful to you, please star the repo — it takes a second and genuinely helps. And if you'd like to fuel development, you can ❤️ sponsor me — every feature stays free for everyone.

🆕 New in 1.9.0 — a full desktop app

StockDock lives in your menu bar, but now it also opens into a complete desktop window. Click Open in the popover for your watchlist, portfolios, live charts, and news in one spacious view — everything stays in sync with the menu bar.

<img src="screenshots/desktop.png" alt="StockDock desktop window — portfolio overview with value chart, P&L, allocation and movers" width="100%">

Also new: separate Price and After-hours columns in the watchlist (each sortable), news search by headline or ticker, add-to-portfolio straight from a stock's detail, sharper forex / sub-dollar price precision, and adjustable decimal places for percentages and values.

Why StockDock?

• 🆓 Truly free & open source — no paid tiers, no premium lock, no subscription, ever.
• 🔒 Private by design — no account, no login, no analytics, no telemetry. Your watchlist and portfolio never leave your Mac.
• ⚡️ Live in your menu bar — real-time P&L and prices without opening a single browser tab.
• 🖥️ Full desktop app too — open a spacious window for watchlist, portfolios, charts, and news whenever you want more room.
• 🌍 Multi-currency — track holdings in mixed currencies and see totals converted to yours, with historical rates on your cost basis.
• 🔔 Alerts that reach you — native macOS notifications plus optional Discord / Slack webhooks.
• 🍎 Native & lightweight — pure SwiftUI, universal binary (Apple Silicon + Intel), auto-updating via Sparkle.

What you can track

Stocks, ETFs, indices (S&P 500, NASDAQ…), crypto, and forex — anything with a Yahoo Finance symbol. Search by symbol, company name, or ISIN (e.g. AAPL, Tesla, IE00B4L5Y983).

Screenshots

Desktop window

In the menu bar

The popover — watchlist, portfolios & settings

<div align="center"> <img src="screenshots/demo.gif" alt="StockDock menu bar popover cycling through the watchlist, portfolio P&L and settings" width="440"> </div>

| Watchlist | Portfolios | Settings | |---|---|---| | | | |

Features

• Menu Bar P&L — See your portfolio performance at a glance, always visible
• Desktop Window — Open a full app window from the menu bar: watchlist, portfolios, live charts, and news, all in sync
• Watchlist — Track any stock by symbol, name, or ISIN with live prices and daily change, with separate Price and after-hours columns you can sort
• News Search — Filter market news by headline, ticker, or publisher
• 52-Week Range — A range bar in the watchlist showing where the price sits between its yearly low and high
• Portfolios — Create multiple portfolios with holdings, average cost, purchase date, and P&L
• Long & Short + Leverage — Track short positions and leveraged holdings with correct P&L math (optional, off by default)
• Export / Import — Export single or all portfolios to JSON and import them back
• Extended Hours — Pre-market and after-hours prices with PRE/POST badges
• Overnight & Weekends — Optional Hyperliquid 24/7 prices when there's no Pre/Post session (overnight, weekends, holidays), so your portfolio keeps moving with the market (off by default, under Extended Hours)
• Currency Conversion — Convert stock prices and portfolio values to your preferred currency
• Price Alerts — One-shot alerts on price thresholds, daily change %, or proximity to 52-week high/low
• Portfolio Notifications — Per-portfolio alerts for daily change %, change amount, value milestones, and a daily summary
• Discord / Slack Webhooks — Mirror every notification to a Discord or Slack webhook with colored embeds
• Customizable Watchlist — Toggle company name, day range, 52-week bar, and absolute change per row
• Customizable Menu Bar — Choose what to display: P&L, total value, percentages, best/worst stock, or just an icon
• 7 Languages — English, Simplified Chinese, German, French, Spanish, Italian, Portuguese
• Auto-Updates — Updates are delivered automatically via Sparkle, no manual downloads needed

Install

Homebrew (recommended)

brew install simonsruggi/tap/stockdock

The app updates itself automatically via Sparkle — no need to run brew upgrade.

Download

1. Download StockDock.dmg (or StockDock.zip from Releases)
2. Open it and drag StockDock.app into Applications
3. Launch — the app appears in the menu bar (no Dock icon)

All versions and their changelogs: stockdockapp.com/downloads.

Build from source

Requires Xcode 15+ and macOS 14 Sonoma or later.

git clone https://github.com/simonsruggi/StockDock.git
cd StockDock
xcodebuild -scheme StockDock -configuration Release -destination 'platform=macOS' -derivedDataPath .build/xcode build

The app bundle will be at .build/xcode/Build/Products/Release/.

Use it with Claude and other AI assistants (MCP)

StockDock 1.10.0 and later is also an MCP server: AI assistants that support the Model Context Protocol can read its data and answer questions about it.

| Tool | What it returns | |---|---| | get_portfolio | Holdings with live value, cost, total P&L and today's change, per portfolio and combined | | get_watchlist | Live quotes for your watchlist | | get_quote | Live quote for any Yahoo Finance ticker: stocks, ETFs, crypto (BTC-USD), forex (EURUSD=X) |

Try asking:

• "How is my portfolio doing today?"
• "Which of my holdings lost the most this week vs today?"
• "What's the price of NVDA and BTC right now?"

Claude Code

claude mcp add stockdock -- /Applications/StockDock.app/Contents/MacOS/StockDock --mcp

Claude Desktop, Cursor and other MCP clients — add this to the client's MCP config (Claude Desktop: Settings → Developer → Edit Config; Cursor: ~/.cursor/mcp.json):

{
  "mcpServers": {
    "stockdock": {
      "command": "/Applications/StockDock.app/Contents/MacOS/StockDock",
      "args": ["--mcp"]
    }
  }
}

The menu bar app doesn't need to be running: the client starts StockDock in the background with --mcp, without any window or menu bar icon.

Portfolios and watchlist are read from StockDock's local file and never changed; quotes come from Yahoo Finance, as in the app. Your holdings do reach the AI service you connect, so connect only one you trust with them.

Usage

Watchlist

Add stocks by clicking Add stock at the bottom of the Watchlist tab. Search by symbol, company name, or ISIN (e.g. AAPL, Tesla, IE00B4L5Y983). A local filter box lets you quickly narrow the list by name, symbol, or ISIN. Stocks show:

• Current price with currency symbol
• Daily change (absolute and percentage)
• Day range (low – high)
• A 52-week range bar with a marker showing where the price sits between its yearly low and high
• Extended hours price when available (PRE/POST badge)

Each of these rows can be toggled on/off in Settings → Watchlist Display.

Right-click a stock to remove it, add it to a portfolio, or create a price alert.

Portfolios

1. Click the Portfolios tab
2. Click New portfolio to create one
3. Click Add holding to add a stock with quantity, average price, and purchase date

The purchase date is used to apply the historical exchange rate to your cost basis, so P&L stays accurate across currencies.

Each portfolio shows:

• Total value in your chosen currency
• P&L (profit & loss) in absolute and percentage terms
• Per-holding breakdown with price, value, and individual P&L

Right-click a holding to edit or delete it. Right-click a portfolio header to configure its notifications.

You can Export a single portfolio (or Export All) to a JSON file, and Import portfolios back — imports regenerate IDs and de-duplicate names so nothing is overwritten.

Long / Short & Leverage

By default every holding is a plain long position. Turn on Settings → Advanced → "Enable short positions & leverage" to unlock a Long / Short picker and a per-holding leverage field when adding or editing a holding. P&L, market value, and portfolio percentages are computed with the correct sign and exposure so long and short baskets don't cancel each other out. Existing portfolios are unaffected — the feature is opt-in.

Price Alerts

Create a one-shot alert from a watchlist stock's right-click menu. Six conditions are supported:

• Price rises above a threshold
• Price falls below a threshold
• Daily change rises above a %
• Daily change falls below a %
• Price gets near its 52-week high
• Price gets near its 52-week low

Alerts are evaluated on every price update (WebSocket tick, REST refresh, launch, and wake). When triggered they fire a local macOS notification once, then disarm. Manage them in Settings → Notifications: re-arm, delete, or see the "triggered" badge.

Portfolio Notifications

Right-click a portfolio header → Notifications… to configure per-portfolio alerts. Four modes:

• Daily change ≥ % — fires when the portfolio moves by at least a given percentage
• Daily change ≥ amount — fires on an absolute move in your portfolio currency
• Value milestone — f