Reddit Ads — Claude Code MCP server: what it does, how to install
Connects your MCP assistant to Reddit Ads API v3 with 31 read tools and 22 previewed write actions.
claude mcp add --env REDDIT_ADS_ACCESS_TOKEN=<REDDIT_ADS_ACCESS_TOKEN> --env REDDIT_ADS_REFRESH_TOKEN=<REDDIT_ADS_REFRESH_TOKEN> --env REDDIT_ADS_CLIENT_ID=<REDDIT_ADS_CLIENT_ID> --env REDDIT_ADS_CLIENT_SECRET=<REDDIT_ADS_CLIENT_SECRET> --env REDDIT_ADS_ACCOUNT_IDS=<REDDIT_ADS_ACCOUNT_IDS> --transport stdio reddit-ads -- npx -y @getmcpads/reddit-ads-mcp-serverWhat Reddit Ads does
This server connects your development assistant directly to Reddit Ads API v3 via stdio. It bundles 31 read actions for metrics inspection and 22 write tools that stay inactive until you set REDDIT_ADS_ENABLE_WRITES=true. All write actions execute in preview mode first and require confirm: true to apply, while newly created campaigns and ads remain paused.
Account access is constrained by REDDIT_ADS_ACCOUNT_IDS, accepting IDs prefixed with a2_. Queries targeting unlisted accounts fail instantly, even for data reads. The server renews access tokens directly in memory using your refresh credentials without writing tokens to storage.
Operation requires Node.js 22.23.4, 24.22.1, 26.12.1 or newer. Omitting REDDIT_ADS_ACCOUNT_IDS stops the server from handling any platform requests.
What it helps with
- retrieve performance reporting and campaign spending from Reddit
- inspect targeting configurations on allowed advertising accounts
- draft paused campaigns and ad groups with schema checks
- verify account currency and status using
reddit_health_check
Example prompts for the agent
- Run
reddit_health_checkto see the current ad account timezone and currency - Fetch all campaigns and metrics for account
a2_abc123 - Preview creating an ad group inside account
a2_abc123
How to install Reddit Ads
Platform CLI
claude mcp add --env REDDIT_ADS_ACCESS_TOKEN=<REDDIT_ADS_ACCESS_TOKEN> --env REDDIT_ADS_REFRESH_TOKEN=<REDDIT_ADS_REFRESH_TOKEN> --env REDDIT_ADS_CLIENT_ID=<REDDIT_ADS_CLIENT_ID> --env REDDIT_ADS_CLIENT_SECRET=<REDDIT_ADS_CLIENT_SECRET> --env REDDIT_ADS_ACCOUNT_IDS=<REDDIT_ADS_ACCOUNT_IDS> --transport stdio reddit-ads -- npx -y @getmcpads/reddit-ads-mcp-serverReplace <…> with your own values. 2 more environment variables are in the server README
Platform CLI
codex mcp add reddit-ads --env REDDIT_ADS_ACCESS_TOKEN=<REDDIT_ADS_ACCESS_TOKEN> --env REDDIT_ADS_REFRESH_TOKEN=<REDDIT_ADS_REFRESH_TOKEN> --env REDDIT_ADS_CLIENT_ID=<REDDIT_ADS_CLIENT_ID> --env REDDIT_ADS_CLIENT_SECRET=<REDDIT_ADS_CLIENT_SECRET> --env REDDIT_ADS_ACCOUNT_IDS=<REDDIT_ADS_ACCOUNT_IDS> -- npx -y @getmcpads/reddit-ads-mcp-serverReplace <…> with your own values. 2 more environment variables are in the server README
Config file
{
"mcpServers": {
"reddit-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/reddit-ads-mcp-server"
],
"env": {
"REDDIT_ADS_ACCESS_TOKEN": "<REDDIT_ADS_ACCESS_TOKEN>",
"REDDIT_ADS_REFRESH_TOKEN": "<REDDIT_ADS_REFRESH_TOKEN>",
"REDDIT_ADS_CLIENT_ID": "<REDDIT_ADS_CLIENT_ID>",
"REDDIT_ADS_CLIENT_SECRET": "<REDDIT_ADS_CLIENT_SECRET>",
"REDDIT_ADS_ACCOUNT_IDS": "<REDDIT_ADS_ACCOUNT_IDS>"
}
}
}
}Replace <…> with your own values. 2 more environment variables are in the server README
Config file
{
"servers": {
"reddit-ads": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@getmcpads/reddit-ads-mcp-server"
],
"env": {
"REDDIT_ADS_ACCESS_TOKEN": "<REDDIT_ADS_ACCESS_TOKEN>",
"REDDIT_ADS_REFRESH_TOKEN": "<REDDIT_ADS_REFRESH_TOKEN>",
"REDDIT_ADS_CLIENT_ID": "<REDDIT_ADS_CLIENT_ID>",
"REDDIT_ADS_CLIENT_SECRET": "<REDDIT_ADS_CLIENT_SECRET>",
"REDDIT_ADS_ACCOUNT_IDS": "<REDDIT_ADS_ACCOUNT_IDS>"
}
}
}
}Replace <…> with your own values. 2 more environment variables are in the server README
Platform CLI
gemini mcp add -e REDDIT_ADS_ACCESS_TOKEN=<REDDIT_ADS_ACCESS_TOKEN> -e REDDIT_ADS_REFRESH_TOKEN=<REDDIT_ADS_REFRESH_TOKEN> -e REDDIT_ADS_CLIENT_ID=<REDDIT_ADS_CLIENT_ID> -e REDDIT_ADS_CLIENT_SECRET=<REDDIT_ADS_CLIENT_SECRET> -e REDDIT_ADS_ACCOUNT_IDS=<REDDIT_ADS_ACCOUNT_IDS> reddit-ads npx -y @getmcpads/reddit-ads-mcp-serverReplace <…> with your own values. 2 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Reddit Ads
How to install Reddit Ads in Claude Code?
Run `claude mcp add --env REDDIT_ADS_ACCESS_TOKEN=<REDDIT_ADS_ACCESS_TOKEN> --env REDDIT_ADS_REFRESH_TOKEN=<REDDIT_ADS_REFRESH_TOKEN> --env REDDIT_ADS_CLIENT_ID=<REDDIT_ADS_CLIENT_ID> --env REDDIT_ADS_CLIENT_SECRET=<REDDIT_ADS_CLIENT_SECRET> --env REDDIT_ADS_ACCOUNT_IDS=<REDDIT_ADS_ACCOUNT_IDS> --transport stdio reddit-ads -- npx -y @getmcpads/reddit-ads-mcp-server`.
What does Reddit Ads MCP server do?
It exposes Reddit Ads API v3 tools to MCP clients, providing 31 inspection queries and 22 preview-based mutation commands.
How do I activate write operations?
Supply REDDIT_ADS_ENABLE_WRITES=true in your environment, inspect the generated dry-run payload, and execute the final call with confirm: true.
