Peekd connector for Claude

Before you start

• A Peekd account. Sign up in the web app at app.peekdapp.com or in the iPhone or Android app.
• An email address on your account. You sign in to the connector with it. If you created your account in the app without an email, add one first under Settings → Account in the app.
• Your Instagram username in the app. The tools about your own account need it.
• Peekd Pro, to track other accounts. Prices are on our pricing page.

Peekd can track public Instagram accounts with up to 10,000 followers. It can’t track private accounts or verified accounts. If an account can’t be tracked, the connector tells Claude why.

Set up in Claude Code

Add the connector from your terminal:

claude mcp add --transport http peekd https://mcp.peekdapp.com/mcp

Then run /mcp in Claude Code, choose peekd and sign in with your email and the 6-digit code.

Example prompts

• “Who unfollowed me this week?”
• “Who don’t I follow back on Instagram?”
• “How has my follower count changed this month?”
• “What changed on the accounts I track since Monday?”
• “Start tracking @username and tell me when it has data.”
• “Rescan my account and show me my newest followers.”

What the connector can do

Your own account

• get_my_follower_summary: your follower and following counts, the last scan, your latest new followers and unfollowers, and who doesn’t follow you back.
• list_my_follower_changes: who started or stopped following you, by date.
• list_not_following_back: the full lists in both directions. Long lists come in pages.
• refresh_my_account: rescans your own account. Once per day.
• get_follower_count_history: follower and following counts per day, for your account or an account you track.

Accounts you track

• list_tracked_accounts: the accounts you track, with their counts and how many open slots you have.
• list_tracked_account_activity: follows, unfollows, new and lost followers, profile changes, new posts and new tags. Profile changes show the current value only.
• check_instagram_username: whether an account exists, is public and can be tracked.
• track_account: starts tracking a public account. Needs Peekd Pro and uses one slot.
• refresh_tracked_account: rescans an account you track. Once per hour.
• untrack_account: stops tracking an account.

Permissions

The consent screen asks for two permissions:

• peekd.read: see your follower changes and the public accounts you track.
• peekd.write: add, refresh and remove tracked accounts.

Claude asks you before it runs a tool that changes something, such as starting or stopping tracking.

What data the connector returns

The connector only returns what anyone can currently see on a public Instagram profile.

• Private accounts can’t be tracked.
• It doesn’t return deleted posts.
• It doesn’t return previous captions or bios. Profile changes show the current value only.
• It doesn’t return the insights the Peekd app infers from this data.

Privacy and data handling

• Peekd receives only the tool calls Claude makes: the tool name and its inputs, such as a username. Peekd sends the result back to Claude.
• Peekd does not receive or store your Claude conversations.
• Connection tokens are stored hashed. Access tokens expire after 1 hour. Refresh tokens expire after 60 days without use.
• Deleting your Peekd account deletes all of its connections.

Our privacy policy explains what Peekd stores and why. The results Claude receives become part of your Claude conversation, which Anthropic handles under its own privacy policy.

Disconnect

You can disconnect at any time, in either place:

• In the Peekd app, under Settings → Connected apps.
• In Claude, in your connector settings.

Access stops immediately. To use the connector again, connect it again.

If you don’t want your account tracked

Anyone who doesn’t want their public Instagram account tracked in Peekd can ask to be excluded. Email peekd@reelpop.co with your Instagram username. Private accounts can’t be tracked at all.

Troubleshooting

The sign-in code doesn’t arrive

Check your spam folder and wait a minute before you try again. Make sure you entered the email of your Peekd account. If your account has no email yet, add one in the app under Settings → Account.

“This needs an active Peekd Pro subscription”

You asked for something that needs Peekd Pro, such as tracking another account. Subscribe in the app or the web app, then ask Claude again.

Claude says an account can’t be tracked

Peekd can only track public accounts with up to 10,000 followers that aren’t verified. The connector reports which of these applies.

Claude says no Instagram username is set

The tools about your own account need your Instagram username. Add it in the Peekd app, then try again.

A recent follow or unfollow is missing

Changes aren’t real time. They show up after the next scan of the account. You can ask Claude to rescan your own account once per day and an account you track once per hour.

Claude can’t reach Peekd anymore

If you disconnected in the Peekd app, access was revoked, or you haven’t used the connector for 60 days, connect Peekd again in Claude’s connector settings.

Claude Code asks you to sign in

Run /mcp, choose peekd and sign in again.

Still stuck? Email peekd@reelpop.co or use our contact page.