RecurPost MCP Server

An MCP (Model Context Protocol) server that gives AI assistants access to the RecurPost social media management API.

What can it do?

• List connected social accounts and content libraries

• List workspaces and work inside any workspace you're a member of

• Post content immediately or schedule it for later

• Add content to libraries for recurring/evergreen posting

• View posting history with engagement metrics

• Generate social media content and images with AI

• Get URLs to connect new social media accounts

Related MCP server: Ayrshare Unofficial MCP Server

Setup

1. Get your API key

1. Log in to RecurPost

2. Go to Account Settings

3. Generate an API Password Key (this is not your login password)

2. Install

Claude Desktop (recommended): one-click extension

Works on macOS and Windows. Nothing else to install: Claude Desktop runs the extension with its own built-in Node.js.

1. Download recurpost.mcpb.

2. Double-click the file (or drag it onto Settings > Extensions in Claude Desktop) and click Install.

3. Enter your RecurPost email and API Password Key when asked. The key is stored in your operating system's keychain, not in a plain text file.

The RecurPost tools are available in a new chat straight away. To update, download the latest file and install it again.

Manual setup

The manual routes below need Node.js 18 or newer. Download the LTS installer from https://nodejs.org if node -v in a terminal does not print a version.

Claude Desktop on macOS

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Quit Claude Desktop completely (Cmd+Q, not just the window) and reopen it.

Claude Desktop on Windows

Do not use npx on Windows. Windows has no npx executable (only npx.cmd, which Claude Desktop cannot launch), and even through cmd /c the first-run package download routinely takes longer than the 60-second handshake limit, so the server shows as "running" while every call fails.

Install the package once, then point Claude Desktop straight at it:

1. Open Command Prompt and run:

   npm install -g recurpost-mcp

2. Find where it landed. This prints the global folder:

   npm root -g

   It is normally C:\Users\YOUR-USERNAME\AppData\Roaming\npm\node_modules.

3. Quit Claude Desktop fully first. Closing the window is not enough: right-click the Claude icon in the system tray and choose Quit, or end every Claude.exe in Task Manager. The app rewrites its config file on exit and will discard edits made while it is running.

4. Open %APPDATA%\Claude\claude_desktop_config.json and add, using the folder from step 2 and double backslashes exactly as shown:

   {
     "mcpServers": {
       "recurpost": {
         "command": "C:\\Program Files\\nodejs\\node.exe",
         "args": [
           "C:\\Users\\YOUR-USERNAME\\AppData\\Roaming\\npm\\node_modules\\recurpost-mcp\\build\\index.js"
         ],
         "env": {
           "RECURPOST_EMAIL": "your-email@example.com",
           "RECURPOST_API_KEY": "your-api-key"
         }
       }
     }
   }

   If you save with Notepad, set Save as type to All Files (or it silently adds .txt) and Encoding to UTF-8, not UTF-8 with BOM.

5. Start Claude Desktop. The tools appear within a couple of seconds.

Claude Code on macOS / Linux

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

Claude Code on Windows

One line (the backslash line breaks above are bash-only). After npm install -g recurpost-mcp:

claude mcp add recurpost --scope user -e RECURPOST_EMAIL=your-email@example.com -e RECURPOST_API_KEY=your-api-key -- "C:\Program Files\nodejs\node.exe" "C:\Users\YOUR-USERNAME\AppData\Roaming\npm\node_modules\recurpost-mcp\build\index.js"

On every platform the -e flags must come before --. Anything after -- is passed to the server command, so the server would start without credentials. --scope user makes the server available in every project; omit it to add it to the current project only.

3. Verify

Ask: "Verify my RecurPost connection" (runs user_login), then "Show me all my connected social accounts".

Troubleshooting

Claude Desktop writes a log per server:

• macOS: ~/Library/Logs/Claude/mcp-server-recurpost.log

• Windows: %APPDATA%\Claude\logs\mcp-server-recurpost.log

Available Tools

Workspaces

social_account_list, library_list, history_data, post_content, and add_content_in_library accept an optional workspace_id (a ws_id from workspace_list). When omitted, your default workspace is used. When provided, results and actions are scoped to that workspace — social accounts and libraries must belong to it.

Example prompts

• "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"

• "List my workspaces, then show the social accounts in the Client A workspace"

Security

• Your credentials are stored in your local config and never leave your machine except to authenticate directly with the RecurPost API

• The server runs locally as a subprocess — no external servers involved

• API key and email are passed via environment variables, never exposed to the AI model

License

MIT