Reddit Ads MCP Server - install, status & alternatives [2026]

01 · Install Reddit Ads

before you install - you'll need

Set REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_REFRESH_TOKEN before connecting.

Claude Code

claude mcp add mharnett-mcp-reddit-ads -- npx -y mcp-reddit-ads

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "mharnett-mcp-reddit-ads": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-reddit-ads"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package mcp-reddit-ads - unscoped; check the name against the project README before installing

registry namespace io.github.mharnett is GitHub-verified and matches the repo owner

03 · What Reddit Ads can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can get account info and verify API connectivity, list all ad accounts accessible to the authenticated user, list campaigns with optional status filter, and list ad groups for a campaign.

The 18 tools it gives your agent

Extracted from the project's README - what reddit-ads lets an agent do.

reddit_ads_get_client_context: - Get account info and verify API connectivity
reddit_ads_get_accounts: - List all ad accounts accessible to the authenticated user
reddit_ads_get_campaigns: - List campaigns with optional status filter
reddit_ads_get_ad_groups: - List ad groups for a campaign
reddit_ads_get_ads: - List ads for an ad group
reddit_ads_get_performance_report: - Aggregated performance metrics for campaigns/ad groups/ads
reddit_ads_get_daily_performance: - Day-by-day performance breakdown
reddit_ads_create_campaign: - Create a new campaign (PAUSED by default)
reddit_ads_update_campaign: - Update campaign name, budget, objective, or status
reddit_ads_create_ad_group: - Create a new ad group with targeting (PAUSED by default)
reddit_ads_update_ad_group: - Update ad group bid, targeting, or status
reddit_ads_create_ad: - Create a new ad with headline, body, URL, and media (PAUSED by default)

show all 18 tools

reddit_ads_update_ad: - Update ad creative or status
reddit_ads_pause_items: - Pause multiple campaigns, ad groups, or ads at once
reddit_ads_enable_items: - Enable multiple campaigns, ad groups, or ads at once
reddit_ads_search_subreddits: - Search for subreddits by keyword for targeting
reddit_ads_get_interest_categories: - List available interest categories for targeting
reddit_ads_search_geo_targets: - Search for geographic targeting options (countries, regions, metros)

Latest releases

mcp-reddit-ads-v1.1.3 · 2026-09-03

1.1.3 (2026-09-03) · ad-groups: finish BIDLESS migration - account-scoped update URLs, drop dead bid fields, add tests · ad-groups: finish BIDLESS migration - account-scoped update URLs, drop dead bid fields, add tests…

mcp-reddit-ads-v1.1.2 · 2026-07-09

1.1.2 (2026-07-09) · budget validation, GAQL mutation blocking, future date checks, limit caps · registry lockfile + remove orphan updateNotifier.test.ts · config.json no longer required when using env vars · error…

v1.0.0 · 2026-04-04

Initial release of mcp-reddit-ads - MCP server for Reddit Ads API v3. · Full CRUD for campaigns, ad groups, and ads · Performance reports with daily breakdowns · Subreddit, interest, and geo targeting · Bulk…

04 · Who maintains Reddit Ads

reddit-ads is maintained by mharnett. We track 7 MCP servers from mharnett - 7 actively maintained, 11 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from mharnett.

05 · Facts

repository: github.com/mharnett/mcp-reddit-ads
category: social media - ranked #22 of 47 actively-maintained social media servers as of 2026-09-18.
release cadence: 2 releases in the last 90 days (latest 2026-09-03)
registry: io.github.mharnett/reddit-ads (active, first published 2026-04-08)
packages: npm:mcp-reddit-ads

06 · Reddit Ads FAQ

Is Reddit Ads still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-09 and it shipped 2 releases in the last 90 days. We re-verify nightly.

What can Reddit Ads do?

With this server connected, an agent can get account info and verify API connectivity, list all ad accounts accessible to the authenticated user, list campaigns with optional status filter, and list ad groups for a campaign.

How do I install Reddit Ads?

Run `npx -y mcp-reddit-ads`. The README documents 3 environment variables (REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_REFRESH_TOKEN) to set first. Set REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_REFRESH_TOKEN before connecting. You can also paste the ready-made client config above.

Does Reddit Ads run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Reddit Ads

Alternatives to Reddit Ads

Maintained social media servers if Reddit Ads isn't the fit.

More social media MCP servers · Meta Ads · Meta · YouTube MCP · Reddit MCP Server (mypracticaltools) · Tweetkit X

More TypeScript MCP servers · Console MCP Server · Bantou · Linksee Memory · Safeinstall · Migrationpilot · see all