Framedeck
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_cardswith 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_productionwhich 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_boardto "Sony A7IV review", thencreate_multiple_cardswith all six subtasks in the "Filming" stage.You: "Mark the intro and product shots as done."
Claude: Calls
move_cardtwice 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_overviewfor 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_cardsand 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
Server Config
{
"mcpServers": {
"framedeck": {
"command": "npx",
"args": [
"-y",
"framedeck-mcp"
],
"env": {
"FRAMEDECK_API_KEY": "<YOUR_API_KEY>"
}
}
}
}Recommend Servers
View AllWrite notes to Flomo