Imagine typing a quick message to your AI assistant and having it schedule a week of social media posts. No dashboards to click through. No copy-pasting captions. Just one prompt and it’s handled.

That’s what the RecurPost MCP Server does. It connects AI assistants like Claude directly to your RecurPost account. Your AI can then post content, schedule updates, pull engagement data, and write posts on your behalf.

This guide covers everything. What the server does, how to set it up, and how to start using it.

What Can the RecurPost MCP Server Do?

The server gives your AI assistant direct access to your RecurPost account. You talk to your AI. Your AI talks to RecurPost. Things get done.

Here’s what it can handle:

  • Post or schedule content to any connected social account
  • View your posting history along with engagement numbers
  • Add content to libraries for recurring or evergreen posting
  • List all your social accounts and content libraries at a glance
  • Generate post text and images using AI, right inside the chat
  • Get links to connect new social accounts without leaving the conversation

You don’t need to open RecurPost separately. Your AI assistant handles it all through simple prompts.

How to Get Your API Key

Before setting anything up, you need an API key from RecurPost. This is not your regular login password. It’s a separate key made just for API access.

Here’s how to get it:

  1. Log in to your RecurPost account
  2. Go to Account Settings
  3. Find and generate your API pass_key
RecurPost API Pass Key

Keep this key handy. You’ll need it during the setup steps below.

How to Install the RecurPost MCP Server

You can set this up in two ways: through Claude Desktop or Claude Code. Pick whichever one you use.

Option 1: Claude Desktop

Open your Claude Desktop config file. The location depends on your operating system:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

Add this to the file:

{
  "mcpServers": {
    "recurpost": {
      "command": "npx",
      "args": ["-y", "recurpost-mcp"],
      "env": {
        "RECURPOST_EMAIL": "your-email@example.com",
        "RECURPOST_API_KEY": "your-api-key"
      }
    }
  }
}

Replace your-email@example.com with your RecurPost login email. Replace your-api-key with the key you generated above.

Save the file and restart Claude Desktop. That’s it.

Option 2: Claude Code

If you use Claude Code, run this command in your terminal:

claude mcp add recurpost -- npx -y recurpost-mcp \
  -e RECURPOST_EMAIL=your-email@example.com \
  -e RECURPOST_API_KEY=your-api-key

Again, swap in your actual email and API key. The server will be ready to use right away.

Available Tools

Once connected, your AI assistant gets access to nine tools inside RecurPost. Here’s what each one does:

ToolWhat It Does
user_loginChecks that your API credentials are working
social_account_listShows all your connected social media accounts
library_listLists all your content libraries
connect_social_account_urlsGives you links to connect new social accounts
history_dataPulls posting history for any social account
post_contentPosts or schedules content to a social account
add_content_in_libraryAdds content to a library for recurring use
generate_content_with_aiWrites social media post text for you
generate_image_with_aiCreates images from a text description

You don’t need to call these tools manually. Just type what you want, and your AI assistant picks the right one.

Example Prompts to Get You Started

Not sure what to type? Here are some prompts you can use directly:

  • “Show me all my connected social accounts”
  • “Schedule a post about our summer sale on my Facebook page for tomorrow at 9am”
  • “Generate a LinkedIn post about remote work productivity tips”
  • “What posts went out on my Twitter account this week?”
  • “Add 5 evergreen tips about social media marketing to my Tips library”

These are just starting points. You can mix and match instructions however you like.

Is It Safe to Use?

Yes. Your credentials stay on your machine. They never get sent to any external server. Only directly to the RecurPost API to verify your account.

The server runs as a local subprocess on your computer. Your API key and email are passed through environment variables. The AI model itself never sees them.

So your login details stay private. Your posts go where you tell them to go. Nothing else.

Quick Summary

The RecurPost MCP Server connects your AI assistant to RecurPost in a few minutes. Once set up, you can schedule posts, generate content, check history, and manage libraries, all from a chat window.

It works with both Claude Desktop and Claude Code. Setup takes under five minutes if you have your API key ready.

Start with the example prompts above and see how much time it saves you. For the latest version and source code, visit the RecurPost MCP GitHub page.