mcp-freshbooks

Instructions

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)