Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "actual-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "${ACTUAL_SERVER_URL}",
        "ACTUAL_PASSWORD": "${ACTUAL_PASSWORD}",
        "ACTUAL_BUDGET_SYNC_ID": "${ACTUAL_BUDGET_SYNC_ID}",
        "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "${ACTUAL_BUDGET_ENCRYPTION_PASSWORD}",
        "ACTUAL_SYNC_TTL_MS": "60000"
      }
    }
  }
}

claude mcp add actual-mcp -e "ACTUAL_SERVER_URL=${ACTUAL_SERVER_URL}" -e "ACTUAL_PASSWORD=${ACTUAL_PASSWORD}" -e "ACTUAL_BUDGET_SYNC_ID=${ACTUAL_BUDGET_SYNC_ID}" -e "ACTUAL_BUDGET_ENCRYPTION_PASSWORD=${ACTUAL_BUDGET_ENCRYPTION_PASSWORD}" -e "ACTUAL_SYNC_TTL_MS=60000" -- npx -y [email protected]

[mcp_servers.actual-mcp]
command = "npx"
args = ["-y", "[email protected]"]
env = { "ACTUAL_SERVER_URL" = "${ACTUAL_SERVER_URL}", "ACTUAL_PASSWORD" = "${ACTUAL_PASSWORD}", "ACTUAL_BUDGET_SYNC_ID" = "${ACTUAL_BUDGET_SYNC_ID}", "ACTUAL_BUDGET_ENCRYPTION_PASSWORD" = "${ACTUAL_BUDGET_ENCRYPTION_PASSWORD}", "ACTUAL_SYNC_TTL_MS" = "60000" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "actual-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "[email protected]"
      ],
      "enabled": true,
      "environment": {
        "ACTUAL_SERVER_URL": "{env:ACTUAL_SERVER_URL}",
        "ACTUAL_PASSWORD": "{env:ACTUAL_PASSWORD}",
        "ACTUAL_BUDGET_SYNC_ID": "{env:ACTUAL_BUDGET_SYNC_ID}",
        "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "{env:ACTUAL_BUDGET_ENCRYPTION_PASSWORD}",
        "ACTUAL_SYNC_TTL_MS": "60000"
      }
    }
  }
}

{
  "mcpServers": {
    "actual-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "${ACTUAL_SERVER_URL}",
        "ACTUAL_PASSWORD": "${ACTUAL_PASSWORD}",
        "ACTUAL_BUDGET_SYNC_ID": "${ACTUAL_BUDGET_SYNC_ID}",
        "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "${ACTUAL_BUDGET_ENCRYPTION_PASSWORD}",
        "ACTUAL_SYNC_TTL_MS": "60000"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=actual-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImFjdHVhbC1tY3BAMS4xNS4xIl0sImVudiI6eyJBQ1RVQUxfU0VSVkVSX1VSTCI6IiR7QUNUVUFMX1NFUlZFUl9VUkx9IiwiQUNUVUFMX1BBU1NXT1JEIjoiJHtBQ1RVQUxfUEFTU1dPUkR9IiwiQUNUVUFMX0JVREdFVF9TWU5DX0lEIjoiJHtBQ1RVQUxfQlVER0VUX1NZTkNfSUR9IiwiQUNUVUFMX0JVREdFVF9FTkNSWVBUSU9OX1BBU1NXT1JEIjoiJHtBQ1RVQUxfQlVER0VUX0VOQ1JZUFRJT05fUEFTU1dPUkR9IiwiQUNUVUFMX1NZTkNfVFRMX01TIjoiNjAwMDAifX0%3D"
}

{
  "servers": {
    "actual-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "${ACTUAL_SERVER_URL}",
        "ACTUAL_PASSWORD": "${ACTUAL_PASSWORD}",
        "ACTUAL_BUDGET_SYNC_ID": "${ACTUAL_BUDGET_SYNC_ID}",
        "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "${ACTUAL_BUDGET_ENCRYPTION_PASSWORD}",
        "ACTUAL_SYNC_TTL_MS": "60000"
      }
    }
  }
}

{
  "mcpServers": {
    "actual-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "${ACTUAL_SERVER_URL}",
        "ACTUAL_PASSWORD": "${ACTUAL_PASSWORD}",
        "ACTUAL_BUDGET_SYNC_ID": "${ACTUAL_BUDGET_SYNC_ID}",
        "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "${ACTUAL_BUDGET_ENCRYPTION_PASSWORD}",
        "ACTUAL_SYNC_TTL_MS": "60000"
      }
    }
  }
}

extensions:
  "actual-mcp":
    enabled: true
    name: "actual-mcp"
    type: stdio
    cmd: "npx"
    args:
      - "-y"
      - "[email protected]"
    envs:
      "ACTUAL_SERVER_URL": "${ACTUAL_SERVER_URL}"
      "ACTUAL_PASSWORD": "${ACTUAL_PASSWORD}"
      "ACTUAL_BUDGET_SYNC_ID": "${ACTUAL_BUDGET_SYNC_ID}"
      "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "${ACTUAL_BUDGET_ENCRYPTION_PASSWORD}"
      "ACTUAL_SYNC_TTL_MS": "60000"
    timeout: 300

Placeholders to fill from your own secret store: ${ACTUAL_PASSWORD}, ${ACTUAL_BUDGET_ENCRYPTION_PASSWORD}. The registry never accepts secret values.

This is a local package: the command runs on your machine.

Quality – / 100not scored

Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.

protocoln/a · weight 25

n/a
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygienen/a · weight 30

n/a
tools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)

stabilityn/a · weight 15

n/a
stability.changes, stability.rug_pulltool list unknown

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvabledependencies not resolved yet

Tool list unknown · checked 2026-10-20 16:30 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 96 / 100

provenance90

livenessn/a

freshness100

hygiene100

+repository +namespace-matches-repo +website ~liveness-unmeasured +updated-0d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

[email protected] npmnot resolved yet; dependencies are read once a day

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

package	registry	version	runtime	secrets
`actual-mcp`	npm	1.15.1	npx	`ACTUAL_PASSWORD`, `ACTUAL_BUDGET_ENCRYPTION_PASSWORD`
`actual-mcp`	npm	1.15.1	npx	`ACTUAL_PASSWORD`, `ACTUAL_BUDGET_ENCRYPTION_PASSWORD`

Tools (0)

No tools observed. Local packages are never executed by the registry.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "io.github.s-stefanov/actual-mcp",
  "title": "Actual Budget MCP Server",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "1.15.1",
  "packages": [
    {
      "version": "1.15.1",
      "transport": {
        "type": "stdio"
      },
      "identifier": "actual-mcp",
      "runtimeHint": "npx",
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "environmentVariables": [
        {
          "name": "ACTUAL_SERVER_URL",
          "isRequired": true,
          "description": "URL of your Actual Budget server"
        },
        {
          "name": "ACTUAL_PASSWORD",
          "isSecret": true,
          "isRequired": true,
          "description": "Actual Budget server password"
        },
        {
          "name": "ACTUAL_BUDGET_SYNC_ID",
          "isRequired": true,
          "description": "Budget sync ID"
        },
        {
          "name": "ACTUAL_DATA_DIR",
          "description": "Local dir for cached budget data"
        },
        {
          "name": "ACTUAL_BUDGET_ENCRYPTION_PASSWORD",
          "isSecret": true,
          "description": "E2E encryption password, if enabled"
        },
        {
          "name": "ACTUAL_SYNC_TTL_MS",
          "default": "60000",
          "description": "Sync cache TTL in ms"
        }
      ]
    },
    {
      "version": "1.15.1",
      "transport": {
        "url": "http://localhost:3000/mcp",
        "type": "streamable-http"
      },
      "identifier": "actual-mcp",
      "runtimeHint": "npx",
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "packageArguments": [
        {
          "name": "--sse",
          "type": "named"
        },
        {
          "name": "--port",
          "type": "named",
          "value": "3000"
        }
      ],
      "environmentVariables": [
        {
          "name": "ACTUAL_SERVER_URL",
          "isRequired": true,
          "description": "URL of your Actual Budget server"
        },
        {
          "name": "ACTUAL_PASSWORD",
          "isSecret": true,
          "isRequired": true,
          "description": "Actual Budget server password"
        },
        {
          "name": "ACTUAL_BUDGET_SYNC_ID",
          "isRequired": true,
          "description": "Budget sync ID"
        },
        {
          "name": "ACTUAL_DATA_DIR",
          "description": "Local dir for cached budget data"
        },
        {
          "name": "ACTUAL_BUDGET_ENCRYPTION_PASSWORD",
          "isSecret": true,
          "description": "E2E encryption password, if enabled"
        },
        {
          "name": "ACTUAL_SYNC_TTL_MS",
          "default": "60000",
          "description": "Sync cache TTL in ms"
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/s-stefanov/actual-mcp",
    "source": "github"
  },
  "websiteUrl": "https://github.com/s-stefanov/actual-mcp",
  "description": "MCP server exposing Actual Budget accounts, transactions, budgets and reporting to LLM assistants."
}