mcp-planes-server/README.md

Plane API client and server

# 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

```bash
# 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:

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

## Usage

### Development

```bash
npm run dev
```

### Production

```bash
npm run build
npm start
```

## Integration with Claude

Add the following configuration to your Claude Desktop config:

```json
{
  "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