# Confluence List Spaces

> Enumerates every Confluence space visible to the authenticated user. Use for "what spaces are there", "what's the key for the engineering space", or before creating a page when the destination space key isn't already known. This is a read-only operation.

- Skill: `arfar-x/confluence-list-spaces` (Agent Skill)
- Install (CLI): `npx skillmds@latest add arfar-x/confluence-list-spaces`
- Raw SKILL.md: https://api.skillmd.com/api/skills/arfar-x/confluence-list-spaces/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: arfar-x (https://skillmd.com/u/arfar-x)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/arfar-x/confluence-list-spaces

---


# Confluence: List Spaces

**Read-only.** Run from this skill's directory:

```bash
python3 ../confluence/scripts/confluence_tool.py list_spaces [--max_results 100]
```

(First-time setup, once per environment: `pip install -r
../confluence/requirements.txt`.)

Each space's `key` is what every other Confluence tool needs as
`--space_key` -- resolve it here rather than guessing one from a
space's display name.

A space's key and name are stable facts -- if your runtime has
persistent memory, save them the moment you learn them (same turn,
unprompted) rather than calling this again later. See
`../confluence/README.md`'s "Agent memory" section.

If the result contains `"error"`, tell the user what went wrong in
plain language instead of retrying silently or fabricating a result.

See `../confluence/README.md` for architecture details and the full
environment-variable table.