get_folder
Retrieve folder details by ID, including title, description, and contained documents, for efficient project management on the Dart MCP Server.
Instructions
Retrieve an existing folder by its ID. Returns the folder's information including title, description, and all docs within it.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The 12-character alphanumeric ID of the folder |
Implementation Reference
- index.ts:500-506 (handler)Handler for the 'get_folder' tool. Validates the input 'id' using getIdValidated and calls FolderService.getFolder(id) to fetch the folder details, returning them as JSON-formatted text.
case GET_FOLDER_TOOL.name: { const id = getIdValidated(args.id); const folder = await FolderService.getFolder(id); return { content: [{ type: "text", text: JSON.stringify(folder, null, 2) }], }; } - tools.ts:598-613 (schema)Input schema and metadata definition for the 'get_folder' tool, requiring a folder 'id' matching the 12-character alphanumeric pattern.
export const GET_FOLDER_TOOL: Tool = { name: "get_folder", description: "Retrieve an existing folder by its ID. Returns the folder's information including title, description, and all docs within it.", inputSchema: { type: "object", properties: { id: { type: "string", description: "The 12-character alphanumeric ID of the folder", pattern: "^[a-zA-Z0-9]{12}$", }, }, required: ["id"], }, }; - index.ts:192-214 (registration)Registration of the 'get_folder' tool (as GET_FOLDER_TOOL) in the TOOLS array, which is exposed via the ListToolsRequestSchema handler.
const TOOLS = [ // Config GET_CONFIG_TOOL, // Tasks CREATE_TASK_TOOL, LIST_TASKS_TOOL, GET_TASK_TOOL, UPDATE_TASK_TOOL, DELETE_TASK_TOOL, // Docs CREATE_DOC_TOOL, LIST_DOCS_TOOL, GET_DOC_TOOL, UPDATE_DOC_TOOL, DELETE_DOC_TOOL, // Comments ADD_TASK_COMMENT_TOOL, LIST_TASK_COMMENTS_TOOL, // Other GET_DARTBOARD_TOOL, GET_FOLDER_TOOL, GET_VIEW_TOOL, ];