Folder Operations

As you create more presentations, finding the right one gets harder — for you and your AI assistant. Folders give your Shelf a structure that both of you can navigate naturally.

Every user has a Shelf — a root folder where all decks live by default. You create folders in the Rideful sidebar to organize decks by project, client, or any category that makes sense to you. Folders are flat (no nesting) and each deck lives in exactly one folder at a time.

When you connect an AI assistant to Rideful via MCP, it can see your folder structure, find decks within specific folders, and place new presentations where they belong. If you ask, it can also move decks around or create new folders for you.

Navigating Your Folders

When your AI assistant needs to find a presentation or figure out where to put a new one, it starts by reading your folder structure with folder_list. This gives it the full picture — your Shelf, every folder you've created, and how many decks are in each. The Shelf is always listed first. This is a read-only operation.

Parameters

No parameters required. Returns all folders for the authenticated user.

What It Returns

• folders — array of folders, each with:
• id — folder ID (use this with other tools)
• name — folder name (“Shelf” for the root)
• deckCount — number of decks in this folder
• isRoot — true for the Shelf (root folder)

Example

folder_list()

// Response:
// Your folders:
//
// Shelf (8 decks) — default
// 1. Work (5 decks)
// 2. Personal (3 decks)
// 3. Client A (2 decks)
//
// Use a folder ID with deck_list to filter by folder.

Creating a Folder

You can create folders in the Rideful sidebar, or ask your AI assistant to do it for you — “create a folder called Work.” Behind the scenes it calls folder_create. The folder starts empty — new decks can be placed there with deck_create, or existing decks can be moved in with deck_move_to_folder.

Parameters

What It Returns

• id — the new folder's ID
• name — the folder name
• order — the folder's display position in the sidebar

Example

folder_create({ name: "Q1 Projects" })

// Response:
// {
//   id: "folder_abc123",
//   name: "Q1 Projects",
//   order: 3
// }

Moving Decks When You Ask

Your assistant can also move decks between folders on your behalf. Say “move this deck to Work” or “put it back on the Shelf” and it uses deck_move_to_folder. The deck leaves its current folder and appears in the new one. To move a deck back to the root, it uses the Shelf folder ID (from folder_list). This is a no-op if the deck is already in the target folder.

Parameters

What It Returns

• success — whether the move succeeded
• deckName — the deck that was moved
• folderName — the destination folder

Example

// Move a deck into a folder
deck_move_to_folder({
  deckId: "deck_abc123",
  folderId: "folder_work456"
})

// Response:
// {
//   success: true,
//   deckId: "deck_abc123",
//   deckName: "Q4 Business Review",
//   folderId: "folder_work456",
//   folderName: "Work"
// }

Example — Move Back to Shelf

// Move a deck back to the Shelf (root)
// Use the Shelf folder ID from folder_list
deck_move_to_folder({
  deckId: "deck_abc123",
  folderId: "folder_shelf789"
})

How Your Assistant Uses Folders

Your folder structure isn't just for the sidebar — your assistant is aware of it too. When working with Deck Operations, it can look inside specific folders and place new decks where they belong:

Finding Decks in a Folder

When you say “go to my Work presentations and find the one with the Q3 goals,” your assistant navigates to that folder first. It passes a folderId to deck_list to narrow the search, then works with the deck it finds:

// List decks in a specific folder
deck_list({ folderId: "folder_work456" })

// Returns only decks in the "Work" folder

Placing New Decks in the Right Folder

When you ask for a new presentation and mention a project or category, your assistant can place it in the right folder from the start. It passes a folderId to deck_create or slide_bulk_create. If no folder is specified, the deck lands on your Shelf.

// Create a new deck directly in a folder
slide_bulk_create({
  name: "Sprint Review",
  folderId: "folder_work456",
  slides: [
    {
      layoutId: "builtin-title-slide",
      title: "Sprint 14 Review",
      subtitle: "March 2026"
    }
  ]
})

Related

• Deck Operations — Create, find, and manage presentations (supports folderId parameter)
• MCP Tools Overview — All 26 tools across 10 categories
• Agent Workflow — The recommended workflow for creating presentations