CaCodes MCP Server

Model Context Protocol server for CaCodes (Plane fork) — work items, pages, project memory (AgentMemory RAG), and templates.

PyPI: cacodes-mcp-server
Remote: https://mcp.cacodes.com.br/http/api-key/mcp

Quick install

uvx cacodes-mcp-server install --all
uvx cacodes-mcp-server doctor
uvx cacodes-mcp-server stdio

The install orchestrator configures MCP, runs the PAT wizard (or --auth oauth), validates connectivity, installs GSD and Ponytail from local vendor snapshots, and writes memory-first Cursor rules.

Subcommands

Command	Description
`install`	MCP + GSD + Ponytail + rules + optional doctor
`doctor`	Validate PAT, workspace, MCP, `memory_recall`
`auth`	PAT wizard only (`127.0.0.1:8765/callback`)
`stdio` / `http`	Run MCP server

Cursor (HTTP remote, PAT)

{
  "mcpServers": {
    "cacodes": {
      "url": "https://mcp.cacodes.com.br/http/api-key/mcp",
      "type": "http",
      "headers": {
        "x-api-key": "<cacodes-personal-access-token>",
        "x-workspace-slug": "cacodes"
      }
    }
  }
}

Cursor (OAuth)

{
  "mcpServers": {
    "cacodes": {
      "url": "https://mcp.cacodes.com.br/http/mcp",
      "type": "http"
    }
  }
}

Environment variables

CaCodes (docs)	Env var	Legado (compat.)	Description
CaCodes API Key	`CACODES_API_KEY`	`PLANE_API_KEY`	Personal access token from CaCodes
CaCodes URL	`CACODES_BASE_URL`	`PLANE_BASE_URL`	`https://tarefas.cacodes.com.br`
Workspace	`CACODES_WORKSPACE_SLUG`	`PLANE_WORKSPACE_SLUG`	e.g. `cacodes`
AgentMemory	`AGENTMEMORY_URL`	—	Server-side memory (internal)

Memory-first

GSD + Ponytail are always-on after install. Call cacodes_get_project_context and memory_recall before scanning the codebase. Map context into AgentMemory via cacodes_trigger_reindex — not local .planning/ as source of truth.

Release

Published via .github/workflows/mcp-pypi-publish.yml on GitHub Release. Ponytail vendor snapshot is bundled under plane_mcp/bundled/ponytail.

Metadata

Release files for cacodes-mcp-server 0.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cacodes-mcp-server 0.6.0
File	Size	Uploaded
cacodes_mcp_server-0.6.0.tar.gz	4.8 MB	Aug 29, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for cacodes-mcp-server 0.6.0
File	Interpreter	ABI	Platform	Reset
cacodes_mcp_server-0.6.0-py3-none-any.whl 5.6 MB Aug 29, 2026	Python 3	none	any	Details

Total release size: 10.3 MB

Release files / cacodes_mcp_server-0.6.0.tar.gz

Download URL	cacodes_mcp_server-0.6.0.tar.gz
Size	4.8 MB
Tags	Source
SHA-256 checksum How to use checksums	`476dc7b03ae7f0b9e71e79693a24adc0be52d3566881ae637f4d6b779e3e3ebe`
BLAKE2b-256 checksum How to use checksums	`82c305969ba620d28c8868c91cf70df5b29e83cae60fef6e9eb9c4364d6560b3`
Upload date	Aug 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / cacodes_mcp_server-0.6.0-py3-none-any.whl

Download URL	cacodes_mcp_server-0.6.0-py3-none-any.whl
Size	5.6 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`a661d03ec5b092c78282fbcb2750ead783ed9f8c9527b8d4757343d148f282c1`
BLAKE2b-256 checksum How to use checksums	`48ed1882e47d3ba2b3aeaa8c4fff550975cd2f7e27c762face83cb1ebd356ef0`
Upload date	Aug 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`