MCP PagerDuty

by judexzhu

347 downloads

Not rated

GitHub

About

A Model Context Protocol (MCP) server that provides integration with PagerDuty for incident management and monitoring operations.

Details

Author: judexzhu
Downloads: 347
Categories: Other, Infrastructure

- Early development; functionality not yet fully implemented
- Provides incident list, detail, and notes retrieval tools
- Uses environment variables for PagerDuty API authentication
- Requires Python 3.13+ and the UV package manager
- Compatible with the Model Context Protocol specification
- Community-driven; not affiliated with PagerDuty, Inc.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name MCP PagerDuty

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp pagerduty": {
            "mcp-pagerduty": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp pagerduty": {
            "mcp-pagerduty": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp pagerduty": {
            "mcp-pagerduty": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "mcp pagerduty": {
            "mcp-pagerduty": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp pagerduty": {
            "mcp-pagerduty": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp pagerduty": {
            "mcp-pagerduty": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp pagerduty": {
            "mcp-pagerduty": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp pagerduty": {
            "mcp-pagerduty": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp pagerduty": {
            "mcp-pagerduty": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "mcp pagerduty": {
            "mcp-pagerduty": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp pagerduty": {
            "mcp-pagerduty": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp pagerduty": {
            "mcp-pagerduty": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp pagerduty": {
            "mcp-pagerduty": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp pagerduty": {
            "mcp-pagerduty": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp pagerduty": {
            "mcp-pagerduty": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

From the repository

Clone the repository, install dependencies using uv sync, copy .env.example to .env, and edit the file with your PagerDuty API credentials. Then run the server with python pagerduty.py. The server exposes MCP tools for incident operations.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp pagerduty": {
            "mcp-pagerduty": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-pagerduty": {
        "command": "uv",
        "args": [
            "sync"
        ]
    }
}

MCP PagerDuty

🚧 Early Development - Work in Progress 🚧

A Model Context Protocol (MCP) server that provides integration with PagerDuty for incident management and monitoring operations.

⚠️ Project Status

This project is in its initial development phase. Many features are planned but not yet implemented. Contributions and feedback are welcome!

🚀 Getting Started

Prerequisites

- Python 3.13 or higher
- PagerDuty API token

Installation

1. Clone the repository

   git clone https://github.com/judexzhu/mcp-pagerduty.git

   cd mcp-pagerduty

2. Install dependencies with UV

   uv sync

3. Configure environment

   cp .env.example .env

   # Edit .env with your PagerDuty API credentials

Configuration

Create a .env file with your PagerDuty configuration:

PAGERDUTY_API_TOKEN=your_api_token_here
PAGERDUTY_API_URL=https://api.pagerduty.com

Note: PAGERDUTY_API_URL is optional and defaults to https://api.pagerduty.com if not specified.

🔧 Development

This project is actively under development. Current structure:

mcp-pagerduty/
├── pagerduty.py          # Main MCP server implementation
├── pyproject.toml        # Project configuration
├── .env                  # Environment variables (create from .env.example)
└── README.md            # This file

Running the Server

python pagerduty.py

📚 MCP Integration

This server implements the Model Context Protocol to provide PagerDuty functionality to AI assistants and other MCP clients.

Current Tools

- pagerduty_list_incidents - List incidents with filtering options
- pagerduty_get_incident - Get detailed incident information
- pagerduty_get_incident_notes - Get detailed incident information

Planned Resources

- Incident templates
- Escalation policy information
- Service status dashboards

🤝 Contributing

This project is in early development and contributions are very welcome!

How to Contribute

1. Fork the repository
2. Create a feature branch

   git checkout -b feature/your-feature-name

3. Make your changes
4. Add tests (when testing framework is set up)
5. Submit a pull request

Development Priorities

Current development priorities:
1. 🔴 High Priority: Basic incident listing and retrieval
2. 🟡 Medium Priority: Incident creation and updates
3. 🟢 Low Priority: Advanced features like escalation management

📋 TODO

- [ ] Implement basic MCP server structure
- [ ] Add PagerDuty API client
- [ ] Implement incident management tools
- [ ] Add comprehensive error handling
- [ ] Write tests
- [ ] Add logging and monitoring
- [ ] Create example configurations
- [ ] Write comprehensive documentation

🐛 Known Issues

- Project is in initial development phase
- No functionality implemented yet
- API integration not yet built

📖 Resources

- PagerDuty API Documentation
- Model Context Protocol Specification
- MCP Python SDK

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

Since this project is in early development:
- 📝 Documentation: Coming soon
- 🐛 Bug Reports: Please open an issue
- 💡 Feature Requests: Welcome via issues
- 💬 Questions: Open a discussion or issue

---

Note: This project is not affiliated with PagerDuty, Inc. It's a community-driven integration for the Model Context Protocol.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

MCP PagerDuty

⚠️ Project Status

🚀 Getting Started

Prerequisites

Installation

Configuration

🔧 Development

Running the Server

📚 MCP Integration

Current Tools

Planned Resources

🤝 Contributing

How to Contribute

Development Priorities

📋 TODO

🐛 Known Issues

📖 Resources

📄 License

🆘 Support

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀