Connect Claude Code to APM

APM acts as an MCP (Model Context Protocol) server, allowing AI agents like Claude to directly interact with your projects and tasks. This guide will walk you through connecting Claude Code to APM.

What is MCP?

MCP is an open protocol that enables AI assistants to access tools and data sources. When you connect Claude Code to APM via MCP:

• Claude can see your projects and tasks
• Claude can create new tasks in any project
• Claude can update task status as work progresses
• You get real-time updates in the APM interface

Think of it as giving Claude hands to manipulate your project management system directly.

Prerequisites

Before connecting, ensure you have:

1. APM running with at least one project created
2. Claude Code or another AI agent that supports MCP installed
3. APM MCP Server (included with APM)

Step 1: Start APM's MCP Server

APM includes a built-in MCP server that advertises itself on your local network. Let's verify it's running:

1. Open APM if it's not already running
2. Click the Main Menu button in the project sidebar
3. Select the MCP tab in the Main Menu

You should see:

• Server Status: Running ✅
• Server Name: APM MCP Server
• Clients Connected: 0 connected (if you haven't set this up yet)
• Available Tools: 6 tools listed

Step 2: Configure Claude Code

If you're using Claude Code:

Add APM MCP Server to Claude Code through the CLI

1. Navigate to your project directory.
2. Add the APM MCP server:

claude mcp add apm /Applications/APM.app/Contents/MacOS/APM-MCP-Server

3. Start a new Claude Code session:

claude

Verify Connection in Claude Code

Start a new Claude Code session and check for APM tools:

/mcp

You should see APM listed as a connected server.

When you select APM and select View Tools, you should see APM's tools listed:

• createAction
• getTasks
• getActions
• updateTask
• updateTask
• createTask
• getProjects
• updateAction

Step 3: Verify the Connection

Let's confirm Claude can communicate with APM:

In Claude Code

1. In your terminal, start Claude Code:

claude

2. Ask Claude to list your projects:

Can you show me my apm projects?

3. Claude will use the getProjects tool to fetch and display your projects

Step 4: Test Task Creation

Now for the exciting part - let Claude create tasks in your projects:

Create a Task via Claude

1. In Claude (Desktop or Code), type (for example):

Create a new task called "Set up development environment" in my Website Redesign project

2. Claude will:

   • Use the getProjects tool to find your project
   • Use the createTask tool to add the task
   • Confirm the task was created

3. Check APM - you'll see the new task appear instantly in your project!

Available MCP Tools

Once connected, Claude has access to these APM tools:

Query Tools (Read-Only)

• getProjects - List all projects with optional filtering
• getTasks - List tasks across projects
• getActions - List workflow actions

Modification Tools

• createTask - Create new tasks in projects
• updateTask - Update task status, descriptions, etc.
• createAction - Create workflow actions
• updateAction - Modify existing actions

What's Next?

Perfect! Claude is now connected to APM. Let's put this integration to work: