MCP Planes Server

A Model Context Protocol (MCP) server for interacting with Planes - Project and issue management tool.

Features

• Project management
  • List all projects
  • Get project details
• Issue tracking
  • List issues
  • Get issue details
  • Create new issues
• Label management
  • List labels
  • Create new labels

Installation

# Clone the repository
git clone https://github.com/yourusername/mcp-planes-server.git

# Install dependencies
cd mcp-planes-server
npm install

# Copy environment variables
cp .env.example .env

Configuration

Edit the .env file and set your Planes API credentials:

PLANES_API_URL=https://planes.inner.youdao.com/api
PLANES_API_KEY=your_api_key_here

Usage

Development

npm run dev

Production

npm run build
npm start

Integration with Claude

Add the following configuration to your Claude Desktop config:

{
  "mcpServers": {
    "planes": {
      "command": "npx",
      "args": ["-y", "mcp-planes-server"],
      "env": {
        "PLANES_API_URL": "https://planes.inner.youdao.com/api",
        "PLANES_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available Tools

Project Tools

• list_projects: List all accessible projects
• get_project: Get details of a specific project

Issue Tools

• list_issues: List all issues in a project
• get_issue: Get details of a specific issue
• create_issue: Create a new issue in a project

Label Tools

• list_labels: List all labels in a project
• create_label: Create a new label in a project

License

MIT