trello_get_user_boards
Retrieve all Trello boards accessible to your account to explore and manage your workspace. Filter results by open, closed, or all boards as needed.
Instructions
Get all boards accessible to the current user. This is the starting point for exploring your Trello workspace.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| apiKey | Yes | Trello API key (automatically provided by Claude.app from your stored credentials) | |
| token | Yes | Trello API token (automatically provided by Claude.app from your stored credentials) | |
| filter | No | Filter boards by status: "open" for active boards, "closed" for archived boards, "all" for both | open |
Implementation Reference
- src/tools/members.ts:54-120 (handler)The handler function 'handleTrelloGetUserBoards' performs the logic of fetching user boards using the Trello API client.
export async function handleTrelloGetUserBoards(args: unknown) { try { const { apiKey, token, filter } = validateGetUserBoards(args); const client = new TrelloClient({ apiKey, token }); const response = await client.getCurrentUser(); const user = response.data; const result = { summary: `User: ${user.fullName || user.username}`, user: { id: user.id, fullName: user.fullName, username: user.username, bio: user.bio, url: user.url, memberType: user.memberType, confirmed: user.confirmed }, boards: user.boards?.filter((board: any) => { if (filter === 'all') return true; if (filter === 'closed') return board.closed; return !board.closed; // 'open' or default }).map((board: any) => ({ id: board.id, name: board.name, description: board.desc || 'No description', url: board.shortUrl, closed: board.closed, lastActivity: board.dateLastActivity, permissions: board.prefs?.permissionLevel || 'unknown' })) || [], organizations: user.organizations?.map((org: any) => ({ id: org.id, name: org.name, displayName: org.displayName, description: org.desc })) || [], rateLimit: response.rateLimit }; return { content: [ { type: 'text' as const, text: JSON.stringify(result, null, 2) } ] }; } catch (error) { const errorMessage = error instanceof z.ZodError ? formatValidationError(error) : error instanceof Error ? error.message : 'Unknown error occurred'; return { content: [ { type: 'text' as const, text: `Error getting user boards: ${errorMessage}` } ], isError: true }; } } - src/tools/members.ts:6-14 (schema)Input validation for 'trello_get_user_boards' tool using Zod.
const validateGetUserBoards = (args: unknown) => { const schema = z.object({ apiKey: z.string().min(1, 'API key is required'), token: z.string().min(1, 'Token is required'), filter: z.enum(['all', 'open', 'closed']).optional() }); return schema.parse(args); }; - src/tools/members.ts:29-52 (registration)MCP Tool registration definition for 'trello_get_user_boards'.
export const trelloGetUserBoardsTool: Tool = { name: 'trello_get_user_boards', description: 'Get all boards accessible to the current user. This is the starting point for exploring your Trello workspace.', inputSchema: { type: 'object', properties: { apiKey: { type: 'string', description: 'Trello API key (automatically provided by Claude.app from your stored credentials)' }, token: { type: 'string', description: 'Trello API token (automatically provided by Claude.app from your stored credentials)' }, filter: { type: 'string', enum: ['all', 'open', 'closed'], description: 'Filter boards by status: "open" for active boards, "closed" for archived boards, "all" for both', default: 'open' } }, required: ['apiKey', 'token'] } };