Skip to main content
The reddit MCP adapter connects to the Reddit OAuth API. Fetch post details and comment threads, create self or link posts, comment, edit, and delete content — useful for community monitoring, moderated publishing, and social automation with human approval.

Prerequisites

  • A Reddit account and a Reddit app (script or web app type)
  • OAuth client ID, client secret, and refresh token for the posting account
  • Moderator or posting permissions on target subreddits
  • A descriptive User-Agent string (Reddit requires unique app identification)
  • project_contributor access in AgentRuntime

Connect in AgentRuntime

1

Create a Reddit application

At reddit.com/prefs/apps, create an app and note the client ID (under the app name) and client secret.
2

Obtain a refresh token

Complete the OAuth authorization code flow for the Reddit account that will post or comment. Store the refresh token securely.
3

Create a connection

Go to Connections and click New custom connection to create a connection with ClientID, ClientSecret, RefreshToken, and UserAgent (e.g. agentruntime:workflow:v1.0 (by /u/yourname)).
4

Add reddit MCP instance

Go to MCP, click Add instance for reddit, wire your connection on Instance config, set the profile active, and save.
5

Test read access

Run mcp_callretrieve_reddit_post on a public post ID before enabling write tools.
See Authentication for binding connections to MCP instances.
Always use human_task approval before create_reddit_post or create_reddit_comment in production subreddits. Respect subreddit rules and Reddit API rate limits.

What you can build

  • Community monitoring — Scheduled fetch_post_comments → LLM sentiment summary → alert on negative trends.
  • Approved publishing — Draft post in workflow → human_taskcreate_reddit_post as self or link post.
  • Support triageget_reddit_post_details on mentions → create ClickUp or GitLab ticket from thread context.
  • Thread cleanupedit_reddit_post_or_comment or delete_reddit_post_or_comment after moderation review.

Tools

Example

Post a link after human approval:

Configuration

Troubleshooting