MCP 服务器

framedeck-mcp

MCP server for Framedeck — a Kanban content production manager for YouTube, Instagram, TikTok and Podcast creators. 32 tools to manage productions, stages, frames, checklists, comments, labels, and time tracking, with full MCP safety annotations.

README

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

Get your API key at framedeck.app > Settings > API Keys
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.