Projects

get_project

Returns details for a specific project including its members, documents, context items, and (when set) a project brief shortcut so the brief is directly addressable for follow-up edits.

Parameters

Name	Type	Required	Default	Description
`project_id`	`string (uuid)`	Yes	—	Project UUID from get_projects

Input Schema

{
  "type": "object",
  "required": [
    "project_id"
  ],
  "properties": {
    "project_id": {
      "type": "string",
      "description": "Project UUID from list_projects."
    }
  }
}

Output Schema

{
  "type": "object",
  "required": [
    "id",
    "name"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Project ID."
    },
    "name": {
      "type": "string",
      "description": "Project name."
    },
    "status": {
      "type": "string",
      "description": "Project status."
    },
    "members": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "role": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "user_id": {
            "type": "integer"
          }
        }
      },
      "description": "Project members."
    },
    "documents": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "stage": {
            "type": "string"
          },
          "web_url": {
            "type": "string"
          },
          "category": {
            "type": [
              "object",
              "null"
            ]
          },
          "content_id": {
            "type": "string",
            "format": "uuid",
            "description": "Content UUID — pass to get_content or update_content."
          },
          "visibility": {
            "type": "string"
          }
        }
      },
      "description": "Documents in this project."
    },
    "created_at": {
      "type": "integer",
      "description": "Unix timestamp of creation."
    },
    "visibility": {
      "type": "string",
      "description": "Visibility setting."
    },
    "context_items": {
      "type": "array",
      "description": "Context items associated with this project."
    },
    "project_brief": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "name": {
          "type": "string"
        },
        "content_id": {
          "type": "string",
          "format": "uuid"
        }
      },
      "description": "The project's pinned brief document, if set. {name, content_id} — same shape as create_project's project_brief field. Pass content_id to update_content / get_content to edit or read the brief. null if the project has no brief set."
    }
  }
}

Instructions

Returns details for a specific project including its members, documents, context items, and (when set) a top-level project_brief shortcut so the brief is directly addressable for follow-up edits via update_content.

Example prompts

"Show me the details of my product launch project"
"What documents are in this project?"
"Open the brief for the Acme project so I can edit it"