# HandlePilot

HandlePilot connects an AI agent to an Instagram workspace for account research, reel analysis, content planning, scripts, and carousels.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2 repo stars
- Author: Handlepilot
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Handlepilot/instagram-mcp
- Updated: 2026-10-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/handlepilot

## What it does

The server lets an agent look up public Instagram profiles and posts, search reels, and break down videos into transcripts and scenes. It can also turn research into a content plan, place ideas on a calendar, and draft scripts or carousels. HandlePilot stores the workspace context and materials.

In Claude Code, connect the MCP server directly or install the plugin, which includes playbook skills such as `/handlepilot:strategy` and `/handlepilot:remix`. Don’t use both connection methods at once: Claude Code will connect twice and list duplicate tools. Sign-in happens in a browser, and free accounts have limits on some features.

## Requirements
- Remote server: `https://app.handlepilot.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http handlepilot https://app.handlepilot.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add handlepilot --url https://app.handlepilot.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "handlepilot": {
            "url": "https://app.handlepilot.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "handlepilot": {
            "type": "http",
            "url": "https://app.handlepilot.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http handlepilot https://app.handlepilot.com/mcp
```

## When to use it
- find public competitor profiles and posts on Instagram
- break down a reel into its transcript, scenes, and structure
- turn research into a content plan and calendar ideas
- adapt a proven post into a script in your voice
- create an editable carousel in a chosen style

## Example prompts
- Research public Instagram profiles and compare their posts.
- Break down this reel and draft a script in my voice with `/handlepilot:remix`.
- Create a content strategy and save it as my plan with `/handlepilot:strategy`.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
