mcp-plane-sse by alfred-nutile-inc - MCP Server

Plane MCP Server (SSE)

The Plane MCP Server brings the power of Model Context Protocol (MCP) to Plane using Server-Sent Events (SSE) transport, allowing AI agents and developer tools to interact programmatically with your Plane workspace over HTTP.

Whether you're building intelligent assistants, automation scripts, or workflow-driven tools, this server provides a seamless HTTP-based bridge to Plane's API—so you can create projects, manage issues, assign tasks, and keep your work in sync with AI-powered tools.

What can you do with it?

This server unlocks all sorts of useful capabilities for anyone working with Plane:

Spin up projects and work items directly from your AI or app interface.
Update progress, assign team members, set properties, or add comments—all programmatically.
Move issues through workflows and update their states on the fly.
Organize work with labels, modules, and cycles.
Analyze data about your team's work across projects.
Build smart apps that interact naturally with Plane—whether it's an AI agent logging work, or a bot keeping projects tidy.

Quick Start

Installation

npm install -g @makeplane/plane-mcp-server

Start the SSE Server

Option 1: Using .env file (recommended)

# Copy the example environment file
cp .env.example .env

# Edit .env with your Plane credentials
# PLANE_API_KEY=your-plane-api-key
# PLANE_WORKSPACE_SLUG=your-workspace-slug
# PORT=3000

# Start the server
plane-mcp-sse-server

Option 2: Using environment variables

# Set your environment variables
export PLANE_API_KEY="your-plane-api-key"
export PLANE_WORKSPACE_SLUG="your-workspace-slug"
export PORT=3000  # optional, defaults to 3000

# Start the server
plane-mcp-sse-server

The server will start and display:

==============================================
PLANE MCP SERVER - SSE TRANSPORT
==============================================

Endpoints:
- Health check: GET http://localhost:3000/health
- SSE stream:   GET http://localhost:3000/sse  
- Messages:     POST http://localhost:3000/messages?sessionId=<id>

Environment Configuration

PLANE_API_KEY - Your Plane API token. You can generate one from the Workspace Settings > API Tokens page (/settings/api-tokens/) in the Plane app.
PLANE_WORKSPACE_SLUG - The workspace slug for your Plane instance. The workspace-slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL.
PLANE_API_HOST_URL (optional) - The host URL of the Plane API Server. Defaults to https://api.plane.so/
PORT (optional) - Port for the SSE server. Defaults to 3000.

How to Use

Basic Client Flow

Establish SSE Connection: Send a GET request to /sse to establish the Server-Sent Events stream
Get Session ID: The server will provide a session ID in the response headers
Send MCP Requests: Use POST requests to /messages?sessionId=<session_id> with JSON-RPC payloads
Receive Responses: Listen to the SSE stream for responses and server events

Health Check

curl http://localhost:3000/health

Response:

{
  "status": "ok",
  "transport": "sse"
}

Example MCP Request

Once you have established an SSE connection and obtained a session ID:

curl -X POST "http://localhost:3000/messages?sessionId=YOUR_SESSION_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_projects",
      "arguments": {}
    }
  }'

Available Tools

Users

get_user - Get the current user's information

Projects

get_projects - Get all projects for the current user
create_project - Create a new project

Issue Types

list_issue_types - Get all issue types for a specific project
get_issue_type - Get details of a specific issue type
create_issue_type - Create a new issue type in a project
update_issue_type - Update an existing issue type
delete_issue_type - Delete an issue type

States

list_states - Get all states for a specific project
get_state - Get details of a specific state
create_state - Create a new state in a project
update_state - Update an existing state
delete_state - Delete a state

Labels

list_labels - Get all labels for a specific project
get_label - Get details of a specific label
create_label - Create a new label in a project
update_label - Update an existing label
delete_label - Delete a label

Issues

get_issue_using_readable_identifier - Get issue details using readable identifier (e.g., PROJ-123)
get_issue_comments - Get all comments for a specific issue
add_issue_comment - Add a comment to an issue
create_issue - Create a new issue
update_issue - Update an existing issue

Modules

list_modules - Get all modules for a specific project
get_module - Get details of a specific module
create_module - Create a new module in a project
update_module - Update an existing module
delete_module - Delete a module

Module Issues

list_module_issues - Get all issues for a specific module
add_module_issues - Add issues to a module
delete_module_issue - Remove an issue from a module

Cycles

list_cycles - Get all cycles for a specific project
get_cycle - Get details of a specific cycle
create_cycle - Create a new cycle in a project
update_cycle - Update an existing cycle
delete_cycle - Delete a cycle

Cycle Issues

list_cycle_issues - Get all issues for a specific cycle
add_cycle_issues - Add issues to a cycle
delete_cycle_issue - Remove an issue from a cycle

Work Logs

get_issue_worklogs - Get all worklogs for a specific issue
get_total_worklogs - Get total logged time for a project
create_worklog - Create a new worklog for an issue
update_worklog - Update an existing worklog
delete_worklog - Delete a worklog

Development

Building from Source

git clone https://github.com/makeplane/plane-mcp-server.git
cd plane-mcp-server
npm install
npm run build

Development Commands

npm run build - Build the project
npm run start:sse - Build and start the SSE server
npm run dev:sse - Quick development build and start
npm run test-startup-sse - Test SSE server startup
npm run lint - Run linter
npm run format - Format code

Transport Options

This server supports both transport methods:

SSE Transport (plane-mcp-sse-server) - HTTP server with Server-Sent Events for streaming and POST for client messages
Stdio Transport (plane-mcp-server) - Traditional MCP server using stdin/stdout for communication

Integration Examples

Custom MCP Client

// Establish SSE connection
const eventSource = new EventSource('http://localhost:3000/sse');
let sessionId;

eventSource.addEventListener('message', (event) => {
  const data = JSON.parse(event.data);
  // Handle MCP responses
  console.log('Received:', data);
});

// Get session ID from headers after connection
fetch('http://localhost:3000/sse', { method: 'HEAD' })
  .then(response => {
    sessionId = response.headers.get('mcp-session-id');
  });

// Send MCP request
async function callTool(name, args) {
  const response = await fetch(`http://localhost:3000/messages?sessionId=${sessionId}`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: Date.now(),
      method: 'tools/call',
      params: { name, arguments: args }
    })
  });
}

Using with MCP-compatible Frameworks

The SSE server is compatible with any MCP client that supports HTTP+SSE transport. Configure your client to:

Connect to the SSE endpoint for receiving messages
Send POST requests to the messages endpoint for outgoing communication

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.