delete_goal

Deletes one saving goal by savingGoalId for the authenticated user.

Use with an AI agent

Export this page as Markdown or bundle it with a task for your agent.

Try a task
Preview the prompt that will be copied

Access

  • Effect: Deletes data
  • Required scope: write (the mcp scope also grants it)

Example request

The JSON-RPC message an MCP client sends to call this tool. Your client builds it for you; this is for reference and debugging in a tool such as MCP Inspector.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "delete_goal",
    "arguments": {}
  }
}

Example IDs refer to fictional demo data. Replace them with IDs from your account before calling the real server.

Description

Deletes one saving goal by savingGoalId for the authenticated user.

Get savingGoalId from list_goals, read_goal, or create_goal, or pass goalName with the exact goal name.
goalName auto-resolves only on an exact (case-insensitive) match; partial matches return the candidates to confirm.
If savingGoalId is unknown, call list_goals first.

Input parameters

NameTypeRequiredDescription
goalNamestringNo
savingGoalIdstringNo
Full input schema (JSON Schema)
json
{
  "additionalProperties": false,
  "properties": {
    "goalName": {
      "type": [
        "null",
        "string"
      ]
    },
    "savingGoalId": {
      "type": "string"
    }
  },
  "type": "object"
}