list_projects
Retrieve and display project records from FreshBooks to manage client work, track progress, and organize business activities.
Instructions
List projects.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| per_page | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/mcp_freshbooks/server.py:411-428 (handler)The list_projects tool implementation, using the projects_list client helper to fetch and format project data.
@mcp.tool() @_handle_errors async def list_projects( page: int = 1, per_page: int = 25, ) -> str: """List projects.""" result = await client.projects_list("projects", page, per_page) projects = result.get("projects", []) lines = [f"Found {len(projects)} projects\n"] for p in projects: lines.append( f"ID: {p.get('id')} | {p.get('title', 'Untitled')} | " f"client: {p.get('client_id', '-')} | " f"type: {p.get('project_type', '-')} | " f"active: {p.get('active', '-')}" ) return "\n".join(lines)