Actual Budget

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-10-22T12:48:02.938459Z",
      "publishedAt": "2026-10-22T12:48:02.938459Z",
      "statusChangedAt": "2026-10-22T12:48:02.938459Z"
    }
  },
  "server": {
    "name": "io.github.henfrydls/actual-budget-mcp",
    "icons": [
      {
        "src": "https://raw.githubusercontent.com/henfrydls/actual-budget-mcp/master/assets/icon.png",
        "sizes": [
          "512x512"
        ],
        "mimeType": "image/png"
      }
    ],
    "title": "Actual Budget",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "version": "0.11.0",
    "packages": [
      {
        "version": "0.11.0",
        "transport": {
          "type": "stdio"
        },
        "identifier": "actual-budget-mcp",
        "runtimeHint": "npx",
        "registryType": "npm",
        "environmentVariables": [
          {
            "name": "ACTUAL_SERVER_URL",
            "isRequired": true,
            "description": "URL of your Actual Budget server, for example http://localhost:5006"
          },
          {
            "name": "ACTUAL_PASSWORD",
            "isSecret": true,
            "description": "Password for your Actual Budget server. Not needed if you set ACTUAL_SESSION_TOKEN"
          },
          {
            "name": "ACTUAL_SESSION_TOKEN",
            "isSecret": true,
            "description": "Session token for servers behind OIDC, which have no password. Use instead of ACTUAL_PASSWORD; if both are set, the token wins"
          },
          {
            "name": "ACTUAL_BUDGET_ID",
            "isRequired": true,
            "description": "Your budget's Sync ID, found under Settings > Show advanced settings"
          },
          {
            "name": "ACTUAL_ENCRYPTION_PASSWORD",
            "isSecret": true,
            "description": "Only needed if your budget file is end-to-end encrypted"
          },
          {
            "name": "ACTUAL_READ_ONLY",
            "description": "Set to 1 to hide every write tool from the model, exposing only reads and analysis"
          },
          {
            "name": "ACTUAL_TOOLSET",
            "description": "Set to chat to offer the 17 everyday tools instead of all 43, which is 17.0 KiB of tool descriptions instead of 39.2 KiB on every connection. Defaults to full"
          },
          {
            "name": "ACTUAL_DATA_DIR",
            "description": "Directory for the local budget cache"
          },
          {
            "name": "ACTUAL_HTTP_TIMEOUT_MS",
            "description": "How long to wait for your server to start replying, in milliseconds. Defaults to 60000; raise it if a GoCardless bank sync is being cut off"
          }
        ]
      },
      {
        "transport": {
          "type": "stdio"
        },
        "identifier": "ghcr.io/henfrydls/actual-budget-mcp:0.11.0",
        "registryType": "oci",
        "environmentVariables": [
          {
            "name": "ACTUAL_SERVER_URL",
            "isRequired": true,
            "description": "URL of your Actual Budget server. Inside the container localhost is the container, so use host.docker.internal"
          },
          {
            "name": "ACTUAL_PASSWORD",
            "isSecret": true,
            "description": "Password for your Actual Budget server. Not needed if you set ACTUAL_SESSION_TOKEN"
          },
          {
            "name": "ACTUAL_SESSION_TOKEN",
            "isSecret": true,
            "description": "Session token for servers behind OIDC, which have no password. Use instead of ACTUAL_PASSWORD; if both are set, the token wins"
          },
          {
            "name": "ACTUAL_BUDGET_ID",
            "isRequired": true,
            "description": "Your budget's Sync ID, found under Settings > Show advanced settings"
          },
          {
            "name": "ACTUAL_READ_ONLY",
            "description": "Set to 1 to hide every write tool from the model, exposing only reads and analysis"
          },
          {
            "name": "ACTUAL_TOOLSET",
            "description": "Set to chat to offer the 17 everyday tools instead of all 43, which is 17.0 KiB of tool descriptions instead of 39.2 KiB on every connection. Defaults to full"
          },
          {
            "name": "ACTUAL_HTTP_TIMEOUT_MS",
            "description": "How long to wait for your server to start replying, in milliseconds. Defaults to 60000; raise it if a GoCardless bank sync is being cut off"
          }
        ]
      }
    ],
    "repository": {
      "id": "henfrydls/actual-budget-mcp",
      "url": "https://github.com/henfrydls/actual-budget-mcp.git",
      "source": "github"
    },
    "websiteUrl": "https://actual-mcp.henfrydls.com",
    "description": "Actual Budget, carefully: deletes preview first, and new transactions check for duplicates."
  }
}