framedeck-mcp

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)

| Tool | Description | |------|-------------| | set_active_board | Set the active production context | | get_active_board | Show current active production | | list_boards | List all productions/projects | | create_board | Create a new production or project | | list_columns | List stages in a board | | create_column | Create a new stage | | delete_column | Delete a stage | | list_cards | List cards/frames with filters | | create_card | Create a card/frame | | create_multiple_cards | Batch create (up to 50) | | update_card | Update title, description, priority, due date | | move_card | Move to a different stage | | delete_card | Permanently delete | | archive_card | Soft delete (restorable) | | duplicate_card | Copy with checklist and labels | | set_card_color | Color-code a card | | add_comment | Add a comment | | add_checklist_item | Add a subtask | | toggle_checklist_item | Check/uncheck a subtask | | add_labels_to_card | Add labels to a card | | remove_label_from_card | Remove a label | | get_card_details | Full card info | | search_cards | Search by keyword | | assign_card | Assign a team member | | get_my_cards | Cards grouped by status | | get_board_overview | Board summary with overdue items | | list_labels | List all labels | | create_label | Create a label | | link_commit | Link a git commit to a card | | log_work | Log time spent | | get_sprint_summary | Activity summary | | graduate_to_production | Promote idea to full production |

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