create_project
Set up new projects in Goodday by defining name, template, owner, dates, and optional details for sub-projects, colors, or deadlines using structured inputs.
Instructions
Create a new project in Goodday.
Args: name: Project name created_by_user_id: ID of user creating the project project_template_id: Project template ID (found in Organization settings → Project templates) parent_project_id: Parent project ID to create a sub project color: Project color (1-24) project_owner_user_id: Project owner user ID start_date: Project start date (YYYY-MM-DD) end_date: Project end date (YYYY-MM-DD) deadline: Project deadline (YYYY-MM-DD)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| color | No | ||
| created_by_user_id | Yes | ||
| deadline | No | ||
| end_date | No | ||
| name | Yes | ||
| parent_project_id | No | ||
| project_owner_user_id | No | ||
| project_template_id | Yes | ||
| start_date | No |
Implementation Reference
- goodday_mcp/main.py:337-390 (handler)The primary handler for the 'create_project' tool. Registered via @mcp.tool() decorator. Constructs a JSON payload from input parameters and performs a POST request to the Goodday API endpoint 'projects/new-project' using the make_goodday_request helper. Formats and returns the result or error message.@mcp.tool() async def create_project( name: str, created_by_user_id: str, project_template_id: str, parent_project_id: Optional[str] = None, color: Optional[int] = None, project_owner_user_id: Optional[str] = None, start_date: Optional[str] = None, end_date: Optional[str] = None, deadline: Optional[str] = None ) -> str: """Create a new project in Goodday. Args: name: Project name created_by_user_id: ID of user creating the project project_template_id: Project template ID (found in Organization settings → Project templates) parent_project_id: Parent project ID to create a sub project color: Project color (1-24) project_owner_user_id: Project owner user ID start_date: Project start date (YYYY-MM-DD) end_date: Project end date (YYYY-MM-DD) deadline: Project deadline (YYYY-MM-DD) """ data = { "name": name, "createdByUserId": created_by_user_id, "projectTemplateId": project_template_id } if parent_project_id: data["parentProjectId"] = parent_project_id if color: data["color"] = color if project_owner_user_id: data["projectOwnerUserId"] = project_owner_user_id if start_date: data["startDate"] = start_date if end_date: data["endDate"] = end_date if deadline: data["deadline"] = deadline result = await make_goodday_request("projects/new-project", "POST", data) if not result: return "Unable to create project: No response received" if isinstance(result, dict) and "error" in result: return f"Unable to create project: {result.get('error', 'Unknown error')}" return f"Project created successfully: {format_project(result)}"
- goodday_mcp/main.py:15-57 (helper)Helper function make_goodday_request used by create_project to send authenticated HTTP requests to the Goodday API, handling POST for project creation.async def make_goodday_request(endpoint: str, method: str = "GET", data: dict = None, subfolders: bool = True) -> dict[str, Any] | list[Any] | None: """Make a request to the Goodday API with proper error handling.""" api_token = os.getenv("GOODDAY_API_TOKEN") if not api_token: raise ValueError("GOODDAY_API_TOKEN environment variable is required") headers = { "User-Agent": USER_AGENT, "gd-api-token": api_token, "Content-Type": "application/json" } # Automatically add subfolders=true for project task and document endpoints if not already present if subfolders and endpoint.startswith("project/") and ("/tasks" in endpoint or "/documents" in endpoint): if "?" in endpoint: if "subfolders=" not in endpoint: endpoint += "&subfolders=true" else: endpoint += "?subfolders=true" url = f"{GOODDAY_API_BASE}/{endpoint.lstrip('/')}" async with httpx.AsyncClient() as client: try: if method.upper() == "POST": response = await client.post(url, headers=headers, json=data, timeout=30.0) elif method.upper() == "PUT": response = await client.put(url, headers=headers, json=data, timeout=30.0) elif method.upper() == "DELETE": response = await client.delete(url, headers=headers, timeout=30.0) else: response = await client.get(url, headers=headers, timeout=30.0) response.raise_for_status() return response.json() except httpx.HTTPStatusError as e: raise Exception(f"HTTP error {e.response.status_code}: {e.response.text}") except httpx.RequestError as e: raise Exception(f"Request error: {str(e)}") except Exception as e: raise Exception(f"Unexpected error: {str(e)}")
- goodday_mcp/main.py:115-133 (helper)Helper function format_project used to format the created project's response data into a human-readable string for the tool's output.def format_project(project: dict) -> str: """Format a project into a readable string with safe checks.""" if not isinstance(project, dict): return f"Invalid project data: {repr(project)}" # Defensive defaults in case nested keys are not dicts status = project.get('status') if isinstance(project.get('status'), dict) else {} owner = project.get('owner') if isinstance(project.get('owner'), dict) else {} return f""" Project ID: {project.get('id', 'N/A')} Name: {project.get('name', 'N/A')} Health: {project.get('health', 'N/A')} Status: {status.get('name', 'N/A')} Start Date: {project.get('startDate', 'N/A')} End Date: {project.get('endDate', 'N/A')} Progress: {project.get('progress', 0)}% Owner: {owner.get('name', 'N/A')} """.strip()
- goodday_mcp/main.py:9-9 (registration)Initialization of the FastMCP server instance where tools like create_project are registered via decorators.mcp = FastMCP("goodday-mcp")