nextcloud-mcp-server/docs/deck.md

Deck App

Deck Tools

Tool	Description
deck_create_board	Create a new Deck board with title and color
deck_create_stack	Create a new stack in a board
deck_update_stack	Update stack title and order
deck_delete_stack	Delete a stack and all its cards
deck_create_card	Create a new card in a stack with full options (title, description, due date, etc.)
deck_update_card	Update any aspect of a card (title, description, owner, order, etc.)
deck_delete_card	Delete a card
deck_archive_card	Archive a card
deck_unarchive_card	Unarchive a card
deck_reorder_card	Move/reorder cards within or between stacks
deck_create_label	Create a new label in a board
deck_update_label	Update label title and color
deck_delete_label	Delete a label
deck_assign_label_to_card	Assign a label to a card
deck_remove_label_from_card	Remove a label from a card
deck_assign_user_to_card	Assign a user to a card
deck_unassign_user_from_card	Remove a user assignment from a card

Deck Resources

Resource	Description
nc://Deck/boards	List all deck boards
nc://Deck/boards/{board_id}	Get details of a specific board
nc://Deck/boards/{board_id}/stacks	List all stacks in a board
nc://Deck/boards/{board_id}/stacks/{stack_id}	Get details of a specific stack
nc://Deck/boards/{board_id}/stacks/{stack_id}/cards	List all cards in a stack
nc://Deck/boards/{board_id}/stacks/{stack_id}/cards/{card_id}	Get details of a specific card
nc://Deck/boards/{board_id}/labels	List all labels in a board
nc://Deck/boards/{board_id}/labels/{label_id}	Get details of a specific label

Deck Project Management

The server provides complete Nextcloud Deck integration, enabling you to manage projects, tasks, and workflows:

• Create and manage boards, stacks, and cards
• Organize tasks with labels and user assignments
• Archive/unarchive cards and reorder within or between stacks
• Full CRUD operations on all Deck entities
• Browse project structure through hierarchical resources

Usage Examples:

# Create a new project board
await deck_create_board(title="Website Redesign", color="1976D2")

# Create workflow stacks
await deck_create_stack(board_id=1, title="To Do", order=1)
await deck_create_stack(board_id=1, title="In Progress", order=2)
await deck_create_stack(board_id=1, title="Done", order=3)

# Create task cards with details
await deck_create_card(
    board_id=1,
    stack_id=1,
    title="Design new homepage",
    description="Create mockups for the new homepage layout",
    type="plain",
    order=1,
    duedate="2025-08-15T17:00:00"
)

# Create and assign labels for organization
await deck_create_label(board_id=1, title="High Priority", color="F44336")
await deck_create_label(board_id=1, title="UI/UX", color="9C27B0")

# Assign labels and users to cards
await deck_assign_label_to_card(board_id=1, stack_id=1, card_id=1, label_id=1)
await deck_assign_user_to_card(board_id=1, stack_id=1, card_id=1, user_id="designer")

# Move cards through workflow
await deck_reorder_card(
    board_id=1,
    stack_id=1,        # From "To Do"
    card_id=1,
    order=1,
    target_stack_id=2  # To "In Progress"
)

# Update task progress
await deck_update_card(
    board_id=1,
    stack_id=2,
    card_id=1,
    description="Homepage mockups completed, starting development",
    order=1
)

# Complete tasks
await deck_reorder_card(
    board_id=1,
    stack_id=2,        # From "In Progress"  
    card_id=1,
    order=1,
    target_stack_id=3  # To "Done"
)

# Archive completed cards
await deck_archive_card(board_id=1, stack_id=3, card_id=1)