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.1

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.1
File	Size	Uploaded
cacodes_mcp_server-0.6.1.tar.gz	4.8 MB	Sep 22, 2026	Details

Built distribution (wheel)

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

Total release size: 10.4 MB

Release files / cacodes_mcp_server-0.6.1.tar.gz

Download URL	cacodes_mcp_server-0.6.1.tar.gz
Size	4.8 MB
Tags	Source
SHA-256 checksum How to use checksums	`32e9f622eeeb73f403e6037e3922f761493e7f27725e6027eae729fa9c7cd577`
BLAKE2b-256 checksum How to use checksums	`15f450f7c80346bd602fca1e0df7f819fd0b55b648d8ccb3c4d6335c410b7480`
Upload date	Sep 22, 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.1-py3-none-any.whl

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