Threads Analytics for Mac
Threads analytics on your Mac,no server to run.
Download the app, paste your Threads access token, and the full dashboard runs on your Mac. Posts and follower history are stored in a local SQLite database — no hosting bill, no PostgreSQL, no password to set.
macOS 11+ · Apple silicon · Free and open source
Get to know the app
Every chart from the web version, in a native window.
The desktop app runs the same dashboard as the hosted version — all 31 analyses, the posts table, the giveaway picker, and the MCP server — on a local server only your Mac can reach.
A local database.
Everything syncs into a SQLite file on your Mac. No PostgreSQL to provision and no database bill.
No password.
There's no APP_PASSWORD sign-in. The dashboard only listens on your own machine, so the login screen goes away.
Auto-sync, built in.
The scheduler ships switched on: pick an interval in Settings and the app syncs in the background while it's open and your Mac is awake.
Updates itself.
When a new release is out, a notice appears at the top of the dashboard. Select Install and the app replaces itself and relaunches — your data stays put.
Mac or server
Pick the version that fits how you work.
Both run the same open-source dashboard. The difference is where it lives — and what that means for syncing, access, and cost.
 Mac app | Self-hosted web | |
|---|---|---|
| Runs on | Your Mac | A server or cloud platform you choose |
| Database | SQLite, stored on your Mac | PostgreSQL |
| Cost | Free | Your hosting and database plan |
| Sign-in | None needed | APP_PASSWORD |
| Auto-sync | While the app is open and the Mac is awake | Around the clock |
| Open it from | This Mac only | Any browser, phone included |
| MCP clients | Agents on the same Mac, like Claude Code | Any client, including Claude's custom connectors |
| Updates | Install from inside the app | Pull the new image or redeploy |
Sync and the daily follower snapshot only run while the app is open and your Mac is awake: closing the window quits the app, and sleep pauses syncing until the Mac wakes. A day the app never runs gets no follower count, and Threads can't fill it in later — if you need round-the-clock tracking, deploy the web version.
Install
Download, drag, open.
No installer and no Terminal. The app is a ZIP on the project's GitHub Releases page, and current releases are signed with a Developer ID and notarized by Apple.
Download the ZIP
Select Download anywhere on this page. The ZIP comes straight from this project's GitHub Releases.
Open it in Finder
Double-click the ZIP. Finder expands it into the Threads Analytics app.
Move it to Applications
Drag Threads Analytics into your Applications folder.
Open the app
Launch it from Applications. The first time, macOS asks whether to open an app downloaded from the internet — select Open.
Then connect your account
There's no sign-in password. Once the dashboard opens:
- Open SettingsSelect Settings in the sidebar.
- Add your accountSelect Add Threads account and paste your access token.
- Wait for the first syncYour posts start loading right away. How long it takes depends on how many posts your account has.
No access token yet? The token guide walks you through generating one in 18 steps. Read the token guide
System requirements
- macOS 11 Big Sur or later
- A Mac with Apple silicon (M1 or later)
- A Threads access token
- No Node.js, pnpm, or PostgreSQL to install
Only download the app from this project's GitHub Releases. Intel Macs aren't supported yet.
Help
Questions? Answers.
What does macOS ask the first time I open it?
Current releases are signed with a Developer ID and notarized by Apple. The first time you open a newly downloaded version, macOS asks whether to open an app downloaded from the internet. Select Open — that's the only confirmation.
macOS says it can't verify the app. What should I do?
That copy was published before releases were notarized, or it didn't come from this project's GitHub Releases. Move it to the Trash and download the latest release. Never run Terminal commands from an unknown source to switch off Gatekeeper — if the warning persists, report your macOS version and a screenshot of the error.
Open a GitHub issueHow do I update the app?
When a new release is out, a notice appears at the top of the dashboard. Select Install there or in Settings → About, or choose Threads Analytics → Check for Updates… in the menu bar, then Install Update. The app downloads the new version, checks it's signed by this project, then replaces itself and relaunches — so keep it in a folder you can write to, such as Applications. If the notice offers Download instead (early builds without in-app updates), quit the app, download the new ZIP and replace the copy in Applications.
Where does the app keep my data?
The SQLite database and the key that encrypts your access token sit in one folder, separate from the app, so updates never touch them and there's nothing to sync again. Keep the two together: without the key, the stored tokens can't be read.
~/Library/Application Support/Threads AnalyticsWill my access token expire?
Each sync renews your Threads access token once fewer than 30 days remain. Open the app at least once a month with auto-sync on so it doesn't lapse.
How do I uninstall it?
Quit the app and move it to the Trash. To also erase accounts and synced data, delete the folder below — that can't be undone.
~/Library/Application Support/Threads AnalyticsCan an AI agent read my data?
Yes, from the same Mac. The MCP server runs at http://127.0.0.1:43127/api/mcp, so agents like Claude Code can query your analytics. Cloud connectors can't reach it.
Does it run on Intel Macs?
Not yet. Releases are built for Apple silicon only.
Put your Threads history on your Mac.
Download the app, paste your token, and your analytics start building up locally. Want it running around the clock instead? Deploy the web version.
Free and open source · Your synced data stays on your Mac