Installing and Using the Oktopost Claude Code Plugin

The Oktopost Claude Plugin turns Claude into your B2B social media strategist. With this skill enabled, Claude can draft posts, launch and manage campaigns, run analytics, handle advocacy, and interpret results using Oktopost tools and data. You get the automation, brand governance, and B2B best practices of the Oktopost platform directly in your Claude Code workflow, all from one interface.

Typical tasks include launching multi-step campaigns, adapting and scheduling posts, analyzing performance in a B2B context, managing employee advocacy, and monitoring the social inbox. The Plugin builds on the Oktopost MCP server (oktopost-mcp), which handles raw API connectivity and tool execution. You need both installed. The Plugin provides the strategic layer: campaign orchestration, AI-driven content adaptation, analytics interpretation, and governance, on top of the MCP's basic tool access.

Prerequisites

• Claude Code CLI (installation guide)
• Node.js 20+ (download page)

Installing the Oktopost Claude Plugin

You can install the Plugin quickly with a single command or manually with Git for advanced workflows.

Method 1: One-Liner Curl Install

1. Open your terminal.

2. Run the following command:

   curl -fsSL https://raw.githubusercontent.com/Oktopost/oktopost-claude/main/install.sh | sh
   

This downloads and installs the Plugin into your Claude Code skills directory.

Method 2: Manual Git Clone

1. Clone the GitHub repo:

   git clone https://github.com/Oktopost/oktopost-claude.git
   

2. Change to the directory:

   cd oktopost-claude
   

3. Run the install script:

   sh install.sh
   

For more details or source code, see the Oktopost Claude Plugin GitHub repo.

Setting Up the Plugin in Claude Code

Setup is conversational. No shell commands are required after installation.

1. Open Claude Code.

2. Enter the following command:

   /oktopost setup
   

3. When prompted by Claude, provide:

   • Your Oktopost API key (find it on your Oktopost API settings page)
   • Your numeric Oktopost account ID (same page)
   • Your region: US (default) or EU (for European accounts only)

Claude validates your credentials and registers the MCP server automatically. Oktopost tools are enabled for use inside Claude Code.

Advanced and CI Setups

For CI/CD pipelines or non-interactive installs, run the installer with arguments, register MCP servers manually, or rotate API keys as shown below.

Non-Interactive Install with MCP Registration

sh install.sh --with-mcp YOUR_API_KEY ACCOUNT_ID [us|eu]

• ACCOUNT_ID: Your numeric Oktopost account ID.
• YOUR_API_KEY: Your Oktopost API key.
• Region (us or eu): Optional. Defaults to us. Use eu for European accounts.

Manual MCP Registration

You can add the MCP server directly with:

claude mcp add oktopost \
  -e OKTOPOST_ACCOUNT_ID=YOUR_ACCOUNT_ID \
  -e OKTOPOST_API_KEY=YOUR_API_KEY \
  [-e OKTOPOST_ACCOUNT_REGION=eu] \
  -- npx oktopost-mcp

Replace YOUR_ACCOUNT_ID and YOUR_API_KEY with your Oktopost details.

Key Rotation and Uninstall

Rotate API keys without a conversation:

/oktopost setup --key NEW_API_KEY --account ACCOUNT_ID --region us

Uninstall the skill entirely:

sh install.sh --uninstall

This removes the skill and example preset but preserves your personal brand presets in ~/.oktopost/presets/.

Available Plugin Commands

Optional arguments are shown in brackets ([...]). Use /oktopost help for more usage examples in Claude.

Brand Presets and Content Governance

Brand presets structure how Claude creates content and campaigns for your organization.

What brand presets control:

• Voice and tone application
• Hashtag usage and targeting rules
• Content pillars and target audience
• Network priorities and approval settings
• Account credentials for multi-account setups

Preset locations:

• Team presets: .claude/skills/oktopost/presets/ (shared in repo, team-wide)
• Personal presets: ~/.oktopost/presets/ (private to your machine, overrides team presets)

Switch between presets:

/oktopost preset use <name>

Prompts given in conversation (for example, "write in a more playful voice") always override the active preset for that task.

Security, Approval, and Governance

All Plugin actions respect your Oktopost governance and approval processes.

• Posts, campaigns, and advocacy items use existing Oktopost approval workflows. No bypassing or shortcutting governance.
• API keys are scoped. You can use user or service account keys. Rotation and revocation are supported.
• All actions run on your local Claude Code session, relaying data only to the Oktopost API.
• Each event is logged in Oktopost's standard audit trail.

Frequently Asked Questions