Reddit MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Reddit MCP or direct API to post content, reply to comments, moderate subreddits, and fetch trending discussions through natural language.

Reddit logoReddit
Oauth2

Reddit is a social news platform with thriving user-driven communities (subreddits). It's the go-to place for discussion, content sharing, and viral marketing.

48 Tools

Try Reddit now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Reddit
Try asking
TOOLS

Supported Tools

Every Reddit action and event your agent gets out of the box.

Configure flair template

Create a subreddit flair template, or update one by template ID.

Create a Reddit post

Creates a text or link post in a specified subreddit, optionally applying flair.

Delete Reddit comment

Deletes a Reddit comment, identified by its fullname ID, if it was authored by the authenticated user.

Delete a Reddit post

Permanently and irreversibly deletes a Reddit post by its ID.

Edit comment or post

Edits the body text of the authenticated user's own existing comment or self-post on Reddit; cannot edit link posts or titles.

Expand More Comments

Resolve up to 20 child IDs from a `more` placeholder returned by Retrieve Comments for a Post.

Get Reddit listing by sort

Tool to retrieve a listing of Reddit posts sorted by the specified criteria (hot, new, top, rising, controversial, best).

Get authenticated karma breakdown

Get the connected Reddit account's karma grouped by subreddit.

Get controversial posts from all subreddits

Tool to retrieve controversial posts from all subreddits with time filters.

Get inbox message

Retrieve one private message from the connected account's Reddit inbox.

Get user preferences

Tool to retrieve preference settings of the logged in user.

Get modmail conversation

Retrieve one moderator mail conversation and its related objects.

Get Reddit posts by fullname

Retrieve Reddit posts directly by their t3 fullnames.

Get random Reddit post

Retrieve a randomly selected post from a batch of up to 100 hot posts in a specified subreddit, or from r/all if no subreddit is specified.

Get user information

Retrieves information about a specified Reddit user account, including karma scores and gold status.

Get OAuth scopes

Tool to retrieve all available OAuth scopes supported by the Reddit API.

Get subreddit metadata

Retrieve one exact subreddit's public profile metadata, including descriptions, subscriber count, settings, and connected-user relationship fields.

Get subreddit rules

Fetch the explicit posting rules for a subreddit to ensure compliance before posting or commenting.

Search subreddits

Tool to search subreddits by title and description.

Get subreddit traffic

Return hourly, daily, and monthly traffic for a moderated subreddit.

Get Reddit user comments RSS

Retrieve a named Reddit user's comments as a raw Atom feed string.

Get user flair

Fetches the list of user flair assignments for a given subreddit.

Check username availability

Tool to check whether a username is available for registration on Reddit.

Get subreddit wiki page

Retrieve a subreddit wiki page's rendered and Markdown content, optionally at a historical revision or as a comparison between two revisions.

List custom Reddit feed

List posts from a public custom Reddit feed owned by a named user.

List inbox messages

List one inbox view for the connected Reddit account.

List inbox mentions

List username mentions from the connected account's inbox.

List moderation log

List moderation audit events for a subreddit moderated by the account.

List moderation queue

List one moderator review queue for a subreddit.

List modmail conversations

List moderator mail conversations visible to the connected moderator.

List popular subreddits

List communities in Reddit's current activity-based popular ordering.

List subreddit comments

List recent comments across all posts in a subreddit.

List subreddit moderators

List a subreddit's moderators and each moderator's granted permissions.

List subreddit post flairs

List available link/post flairs for a subreddit (including flair_template_id) so posts can satisfy flair-required validation.

List subreddit wiki pages

List the visible wiki page names available in a subreddit.

List subscribed subreddits

List communities subscribed to by the connected Reddit account.

List user activity

List a Reddit user's overview, posts, comments, or account-history views.

Manage subreddit subscription

Subscribe or unsubscribe the connected account from one subreddit.

Mark all inbox messages read

Queue Reddit to mark all inbox items, or selected item types, as read.

Post a comment

Posts a comment on Reddit, replying to an existing submission (post) or another comment.

Prepare Reddit media upload

Registers an image or video with Reddit and returns temporary upload instructions.

Retrieve Comments for a Post

Retrieves a Reddit post and its comments by article ID, with optional sort, limit and depth.

Retrieve posts from subreddit

Retrieve a paginated listing of posts from a specified subreddit, with sort options and a time-period filter for top or controversial posts.

Retrieve specific comment or post

Retrieves selected details for a Reddit comment or post by fullname, without surrounding thread context.

Search across subreddits

Searches Reddit for posts using a query, returning a streamlined `posts` array and pagination cursors.

Send private message

Send a private Reddit message immediately; sending cannot be undone.

Enable or disable inbox replies

Enable or disable inbox replies for a submission or comment.

Vote on Reddit content

Cast or clear one vote only when directly instructed by a human.

SETUP GUIDE

Connect Reddit MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["reddit"],
  mcp: true,
});
Create a session scoped to Reddit and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Retrieve the top 5 hot posts from r/technology",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Reddit request
SETUP GUIDE

Connect Reddit API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["reddit"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Reddit
3

Run Reddit tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Retrieve the top 5 hot posts from r/technology" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Reddit tool calls through the session, and print the final answer

Why Use Composio?

AI Native Reddit Integration

  • Supports both Reddit MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, posting, and moderating Reddit content

Managed Auth

  • Built-in OAuth2 handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Reddit access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Reddit
  • Scoped, least privilege access to Reddit resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with Reddit.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Reddit tool your agent needs.Free to start.

Start building