Lukaris/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: [email protected]
• Issues: https://github.com/Lukaris/framedeck-mcp/issues

License

MIT