outline-mcp
User Guides

Configuration

Full runtime configuration reference with practical production guidance.

Core runtime variables

VariableDefaultRequiredNotes
OUTLINE_API_KEYnoneYesRequired for MCP server calls to Outline
OUTLINE_BASE_URLhttps://app.getoutline.comNoSet to self-hosted endpoint when needed
OUTLINE_ALLOWED_ACTIONSread,write,deleteNoSupported values: read, write, delete, admin
OUTLINE_REQUEST_TIMEOUT_MS15000NoRequest timeout in milliseconds
OUTLINE_RETRY_COUNT2NoRetries for transient upstream errors
OUTLINE_ENABLE_CAPABILITY_PROBEtrueNoProbes optional endpoints on startup

Lease variables

VariableDefaultRequiredNotes
OUTLINE_LEASE_STRATEGYautoNoauto, memory, data_attribute
OUTLINE_LEASE_ATTRIBUTE_IDnoneConditionalRequired when strategy is data_attribute
OUTLINE_LEASE_DEFAULT_TTL_SECONDS600NoDefault lease TTL
OUTLINE_LEASE_MAX_TTL_SECONDS7200NoMax lease TTL

These are mainly used by pnpm e2e:mcp and CI E2E jobs.

VariableDefaultNotes
OUTLINE_E2E_RUN_WRITEtrue (script default)Set false for read-focused CI
OUTLINE_E2E_COLLECTION_IDemptyFixed test collection; if empty, temporary collection may be created
OUTLINE_E2E_EXPORT_COLLECTION_IDemptyExport scenario target
OUTLINE_E2E_MEMBER_COLLECTION_IDemptyMembership scenario target
OUTLINE_E2E_MEMBER_USER_IDemptyMembership user scenario
OUTLINE_E2E_MEMBER_GROUP_IDemptyMembership group scenario
OUTLINE_E2E_EXPORT_ALLfalseEnables export-all scenario

Practical production presets

Reader preset

OUTLINE_ALLOWED_ACTIONS=read

Writer preset

OUTLINE_ALLOWED_ACTIONS=read,write

Operator preset

OUTLINE_ALLOWED_ACTIONS=read,write,delete

Multi-process lease preset

OUTLINE_LEASE_STRATEGY=data_attribute
OUTLINE_LEASE_ATTRIBUTE_ID=your_data_attribute_id

Configuration recommendations

  • Keep one profile per client role and do not mix responsibilities casually.
  • Treat delete access as an operational capability, not a default capability.
  • Use capability probe in most environments so optional tools are gated correctly.

Next step

Continue to Permission Model.