Projects

Projects are the top-level organizational unit in APM. They group related tasks, and configure MCP integrations.

What is a Project?

A project represents a workspace for your team - it could be:

A product you're building
A client engagement
An operational workflow
A research initiative

Key Features

Team Collaboration

Assign tasks to specific people
Track who's working on what in real-time

Task Organization

Filter by status, assignee, or custom fields

MCP Configuration (Coming soon)

Connect project-specific MCP servers
Configure tool permissions
Set up automated workflows

Creating a Project

Projects can be created through:

APM Interface - Use the "Create Project" button in the Projects tab
MCP Tools - External MCP clients can create projects using the createProject tool (coming soon)

Project Properties

Property	Description	Required
`name`	Display name for the project	Yes
`description`	Short description of the project	No
`summary`	Detailed summary of project purpose for use with agentic workflows	No

Project Settings

General: Name, description, summary
Woorking Directory: The location of the project on your local machine for use in agentic tools like Claude Code

Working with Projects via MCP

Querying Projects

MCP clients can use the getProjects tool to list available projects:

# List all projects accessible to this MCP client
projects = mcp_client.call_tool("getProjects", {
  include_archived: false
})

# Filter projects by name
my_projects = mcp_client.call_tool("getProjects", {
  name_contains: "AI Research"
})

Project Events

APM broadcasts these project-related events to connected MCP servers:

apm_project_created - New project created
apm_project_updated - Project settings changed

Best Practices

One Project Per Initiative - Keep projects focused on a single goal or workflow
Clear Naming - Use descriptive names that indicate the project's purpose
Detailed Summary - The more detailed your summary the better the agentic workflows can understand your project