How do I use plane-local-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@plane-local-mcp List all projects in the workspace" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

plane-local-mcp

by JonatanCosta

Overview Schema Related Servers Score Discussions

Python

Remote

plane-local-mcp

MCP (Model Context Protocol) local para Plane Community Edition self-hosted.

Usa a API pública /api/v1/.../issues/ (compatível com Plane CE). Útil para listar projetos, issues, estados, labels, cycles e buscar itens pelo identificador humano (PROJECT-N, ex.: CKTPC-838).

Pré-requisitos

Python >= 3.10
uv instalado e no PATH
Instância Plane CE acessível + API key

Related MCP server: Plane MCP Server

Instalação

git clone https://github.com/JonatanCosta/plane-local-mcp.git
cd plane-local-mcp
uv sync

Anote o caminho absoluto do clone (ex.: /Users/voce/plane-local-mcp). Ele será usado nas configs abaixo.

Variáveis de ambiente

Variável	Obrigatória	Descrição
`PLANE_API_KEY`	sim	API key do Plane
`PLANE_WORKSPACE_SLUG`	sim	Slug do workspace
`PLANE_BASE_URL`	sim	URL base da instância (sem `/api`)

Exemplo:

export PLANE_API_KEY="plane_api_..."
export PLANE_WORKSPACE_SLUG="meu-workspace"
export PLANE_BASE_URL="https://plane.exemplo.com"

Cursor

Edite ~/.cursor/mcp.json (ou Settings → MCP → Add server) e adicione:

{
  "mcpServers": {
    "plane": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/ABS/PATH/plane-local-mcp",
        "plane-local-mcp"
      ],
      "env": {
        "PLANE_API_KEY": "plane_api_...",
        "PLANE_WORKSPACE_SLUG": "meu-workspace",
        "PLANE_BASE_URL": "https://plane.exemplo.com"
      }
    }
  }
}

Substitua /ABS/PATH/plane-local-mcp pelo caminho absoluto do repositório. Reinicie o Cursor (ou recarregue os MCPs) e confira se o servidor plane aparece com as tools.

Claude Desktop

Abra Settings → Developer → Edit Config (cria o arquivo se ainda não existir).
Edite claude_desktop_config.json:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "plane": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/ABS/PATH/plane-local-mcp",
        "plane-local-mcp"
      ],
      "env": {
        "PLANE_API_KEY": "plane_api_...",
        "PLANE_WORKSPACE_SLUG": "meu-workspace",
        "PLANE_BASE_URL": "https://plane.exemplo.com"
      }
    }
  }
}

Feche completamente o Claude Desktop e abra de novo.
No chat, o ícone de ferramentas (martelo) deve listar as tools do Plane.

Dica: se uv não for encontrado, use o caminho absoluto do binário (ex.: /Users/voce/.local/bin/uv).

Claude Code (CLI)

claude mcp add plane --env PLANE_API_KEY=plane_api_... \
  --env PLANE_WORKSPACE_SLUG=meu-workspace \
  --env PLANE_BASE_URL=https://plane.exemplo.com \
  -- uv run --directory /ABS/PATH/plane-local-mcp plane-local-mcp

Ou edite ~/.claude/settings.json / .claude/settings.json com o mesmo bloco mcpServers do Cursor.

Codex (CLI / IDE)

Edite ~/.codex/config.toml (ou .codex/config.toml no projeto, se ele estiver trusted):

[mcp_servers.plane]
command = "uv"
args = [
  "run",
  "--directory",
  "/ABS/PATH/plane-local-mcp",
  "plane-local-mcp",
]

[mcp_servers.plane.env]
PLANE_API_KEY = "plane_api_..."
PLANE_WORKSPACE_SLUG = "meu-workspace"
PLANE_BASE_URL = "https://plane.exemplo.com"

Alternativa via CLI:

codex mcp add plane --env PLANE_API_KEY=plane_api_... \
  --env PLANE_WORKSPACE_SLUG=meu-workspace \
  --env PLANE_BASE_URL=https://plane.exemplo.com \
  -- uv run --directory /ABS/PATH/plane-local-mcp plane-local-mcp

Em uma sessão Codex, use /mcp para validar que o servidor conectou.

Tools disponíveis

Tool	Descrição
`get_instance_info`	Base URL, workspace e estilo de API
`list_projects`	Lista projetos do workspace
`retrieve_project`	Projeto por UUID
`list_states`	Estados (colunas) do projeto
`list_labels`	Labels do projeto
`list_modules`	Modules do projeto
`list_cycles`	Cycles do projeto
`list_issues`	Issues do projeto (`/issues/`)
`retrieve_issue`	Issue por UUID
`get_issue_by_identifier`	Issue por `PROJECT-N` (ex.: `CKTPC-838`)
`list_issue_children`	Filhos de um épico/issue
`update_issue`	Edita título, descrição, prioridade e/ou status
`add_issue_to_cycle`	Adiciona issue a um cycle
`remove_issue_from_cycle`	Remove issue de um cycle

Exemplos de edição

update_issue(identifier="CKTPC-844", name="Novo título")
update_issue(identifier="CKTPC-844", description="Texto simples da descrição")
update_issue(identifier="CKTPC-844", state_name="Em Execução")
add_issue_to_cycle(identifier="CKTPC-844", cycle_name="Payment Sprint - 23")

Notas:

Descrição no Plane usa HTML (description_html). Se passar description em texto puro, o MCP converte para HTML mínimo.
Status e cycle aceitam UUID (state_id / cycle_id) ou nome (state_name / cycle_name).
Cycle não entra no PATCH da issue: a API exige POST .../cycles/{id}/cycle-issues/.

Desenvolvimento

uv sync
uv run plane-local-mcp

O servidor fala MCP via stdio.

Licença

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

Plane MCP Serverofficial
Project Management Developer Tools
makeplane
A
license
B
quality
B
maintenance
A Model Context Protocol server that enables AI interfaces to seamlessly interact with Plane's project management system, allowing management of projects, issues, states, and other work items through a standardized API.
Updated 6 days ago (2026-08-05 03:33 UTC)
46
121
278
MIT
Plane MCP Server
Project Management Developer Tools
disrex-group
A
license
B
quality
C
maintenance
A Model Context Protocol (MCP) server that enables LLMs to interact with Plane.so, allowing them to manage projects and issues through Plane's API. Using this server, LLMs like Claude can directly interact with your project management workflows while maintaining user control and security.
Updated a year ago (2025-08-27 12:13 UTC)
76
36
1
MIT
Plane MCP
Project Management Developer Tools
Rockysingh116
A
license
B
quality
C
maintenance
An MCP server that enables LLMs to fully manage a Plane workspace, including projects, work items, states, labels, cycles, modules, comments, and members.
Updated 2 months ago (2026-06-22 13:08 UTC)
38
MIT
plane-ce-mcp
Project Management Product Management
Bl4nk44
A
license
B
quality
A
maintenance
Unofficial MCP server for self-hosted Plane Community Edition, enabling project management tasks like managing work items, cycles, modules, and initiatives via natural language.
Updated 5 days ago (2026-08-05 14:27 UTC)
100
1
MIT

View all related MCP servers

Related MCP Connectors

PlanExe
MCP server for generating rough-draft project plans from natural-language prompts.
hithereiamaliff-mcp-nextcloud
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Supabase
MCP server for interacting with the Supabase platform

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/JonatanCosta/plane-local-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

plane-local-mcp

Pré-requisitos

Instalação

Variáveis de ambiente

Cursor

Claude Desktop

Claude Code (CLI)

Codex (CLI / IDE)

Tools disponíveis

Exemplos de edição

Desenvolvimento

Licença

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

Plane MCP Serverofficial

Plane MCP Server

Plane MCP

plane-ce-mcp

Related MCP Connectors

Latest Blog Posts

MCP directory API