framedeck-mcp

MCP server for Framedeck — connect any AI assistant to your content production pipeline.

Works with Claude, ChatGPT, Gemini, Copilot, and any MCP-compatible client.

Quick Start

1. Get your API key at framedeck.app > Settings > API Keys
2. Add to your AI assistant config (see below)

Setup

Claude Code

claude mcp add framedeck -e FRAMEDECK_API_KEY=your_key_here -- npx -y framedeck-mcp

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "framedeck": {
      "command": "npx",
      "args": ["-y", "framedeck-mcp"],
      "env": {
        "FRAMEDECK_API_KEY": "your_key_here"
      }
    }
  }
}

Other MCP Clients

Set the environment variable FRAMEDECK_API_KEY and run:

npx framedeck-mcp

Usage Examples

Talk to your AI assistant naturally — here are three end-to-end workflows:

Example 1 — Capture and graduate ideas

You: "I just had 3 video ideas: a knife sharpening tutorial, a Sony A7IV review, and a day-in-the-life vlog. Add them to my idea pool."

Claude (via MCP): Calls create_multiple_cards with the three titles. They land in your Idea Pool's "Ideas" stage.

You: "The knife sharpening one is a go — graduate it to a real production."

Claude: Calls graduate_to_production which creates a new dedicated production with full stages (Idea → Scripting → Filming → Editing → Published) and moves the idea card across.

Example 2 — Plan a production day

You: "For the Sony review, add subtasks: write intro, shoot product shots, record voiceover, edit B-roll, color grade, export final."

Claude: Calls set_active_board to "Sony A7IV review", then create_multiple_cards with all six subtasks in the "Filming" stage.

You: "Mark the intro and product shots as done."

Claude: Calls move_card twice to push them into the "Done" stage.

Example 3 — Get a project overview

You: "How's my channel looking? Anything overdue?"

Claude: Calls get_board_overview for each production. Returns a summary showing card counts per stage, overdue items highlighted in red, and which productions need attention.

You: "What's assigned to me right now?"

Claude: Calls get_my_cards and lists everything you own grouped by board and status.

Tools (32)

Dual Mode

Framedeck supports two board modes:

• Creator mode: Productions, Stages, Frames — for content pipelines
• Classic mode: Projects, Stages, Cards — for standard project management

The MCP server automatically uses the correct terminology based on each board's mode.

Idea Pool

When you add ideas without specifying a board, they automatically land in your Idea Pool. When an idea is ready, use graduate_to_production to create a dedicated production with full stages (Idea > Scripting > Filming > Editing > Published).

Safety Annotations

Every tool ships with MCP safety annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) so AI clients can warn users before destructive actions like delete_card, delete_column, and archive_card.

Privacy & Support

• Privacy Policy: https://framedeck.app/privacy
• Terms of Service: https://framedeck.app/terms
• Support: support@framedeck.app
• Issues: https://github.com/Lukaris/framedeck-mcp/issues

License

MIT