Project Management MCP server for AI agents

The Project MCP Server is a powerful tool for managing project knowledge graphs, helping project managers track progress, dependencies, resources, and team members through a structured representation of project entities and their relationships.

Installation

There are several ways to install and run the Project MCP Server:

Using npx (Easiest Method)

To install and run directly from GitHub using npx:

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "project": {
      "command": "npx",
      "args": [
        "-y",
        "github:tejpalvirk/project"
      ]
    }
  }
}

Global Installation

To install globally and run directly:

npm install -g github:tejpalvirk/project

Then configure Claude Desktop by adding this to your claude_desktop_config.json:

{
  "mcpServers": {
    "project": {
      "command": "contextmanager-project"
    }
  }
}

Using Docker

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "project": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/project"
      ]
    }
  }
}

Configuration

Environment Variables

You can customize where data is stored using environment variables:

MEMORY_FILE_PATH: Path where the knowledge graph data will be stored (default: ./project/memory.json)
SESSIONS_FILE_PATH: Path where session data will be stored (default: ./project/sessions.json)

Example usage:

# Store data in the current directory
MEMORY_FILE_PATH="./pm-memory.json" SESSIONS_FILE_PATH="./pm-sessions.json" npx github:tejpalvirk/contextmanager-project

# Store data in a specific location (absolute path)
MEMORY_FILE_PATH="/path/to/data/project-memory.json" npx github:tejpalvirk/contextmanager-project

Using the Project MCP Server

The server provides several tools for managing project knowledge:

Starting a Session

To begin a new project management session:

Let's start a new project management session to review the Mobile App Development project.

This will generate a unique session ID and display current projects, tasks, milestones, risks, and recent sessions.

Loading Project Context

To view details for a specific entity:

Load the context for the Mobile App Development project so I can see its current status.

Recording Session Results

After completing a project meeting or work session:

I've just finished a project review meeting for Mobile App Development. We completed the UI design milestone, identified 2 new risks related to the backend API, and assigned 3 new tasks to the development team. The UI tasks are now marked as complete, and we've set the API development tasks as high priority. The project is still on track but we need to monitor the API risks closely.

Managing Project Knowledge

Creating new tasks:

Create a new task called "Implement User Authentication" that's part of the Mobile App Development project, assigned to Sarah, with high priority and due in two weeks. Set its status to active and make it precede the "User Profile" task.

Updating task status:

Update the status of the "Database Migration" task to "completed" and add an observation that it was finished ahead of schedule.

Entity Types and Relationships

Main Entities

The server recognizes various entity types:

project: The main container for all related entities
task: Individual work items that need to be completed
milestone: Key checkpoints or deliverables
resource: Materials, tools, or assets
teamMember: People involved in the project
issue: Problems or blockers
risk: Potential future problems
decision: Important choices made during the project
status: Entity status values (inactive, active, complete)
priority: Priority level values (high, low)

Key Relationships

Entities can be connected through relationships such as:

part_of: Indicates an entity is a component of another
depends_on: Shows dependencies between entities
assigned_to: Links tasks to team members
blocks: Indicates one entity is blocking another
has_status: Links entities to their current status
has_priority: Links entities to their priority level
precedes: Indicates sequential task order

Specialized Functions

The server includes domain-specific functions for project management:

getProjectOverview: View all project components
getTaskDependencies: Identify blocked tasks and critical paths
getTeamMemberAssignments: View assignments for team members
getMilestoneProgress: Track progress towards milestones
getProjectRisks: Identify and assess risks
getStatusOverview: View entities with a specific status
getTaskSequence: Visualize task sequences

These capabilities help project managers maintain context continuity, track dependencies, monitor risks, allocate resources effectively, and make informed decisions based on comprehensive project data.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "project" '{"command":"npx","args":["-y","github:tejpalvirk/project"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "project": {
            "command": "npx",
            "args": [
                "-y",
                "github:tejpalvirk/project"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "project": {
            "command": "npx",
            "args": [
                "-y",
                "github:tejpalvirk/project"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect