Servers Playground How we check Add a server Log in

Framezone

Working · 1.2 s

app.framezone/framezonev2.3.0 Domain verified

Your life dashboard for AI: tasks, habits, goals, budgets, workouts, nutrition, journal, notes.

Productivity Health & Science

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://framezone.app/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

add_bookmark

Save a bookmark URL with optional title, description, category, and tags.

urlstring, required

Bookmark URL

tagsarray

Tools (62)

add_bookmark

Save a bookmark URL with optional title, description, category, and tags.

Argument	Type	Description
url*	string	Bookmark URL
tags	array	Tags
title	string	Title (auto-detected from domain if omitted)
category	string	Category
description	string	Description

Input schema (JSON)

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Bookmark URL"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tags"
    },
    "title": {
      "type": "string",
      "description": "Title (auto-detected from domain if omitted)"
    },
    "category": {
      "type": "string",
      "description": "Category"
    },
    "description": {
      "type": "string",
      "description": "Description"
    }
  }
}

add_trade

Record a buy or sell trade for a portfolio holding. Updates shares and average cost.

Argument	Type	Description
type*	string	Trade type
notes	string	Trade notes
shares*	number	Number of shares
traded_at	string	Trade date (Y-m-d, defaults to now)
holding_id*	integer	Holding ID
price_per_share*	number	Price per share

Input schema (JSON)

{
  "type": "object",
  "required": [
    "holding_id",
    "type",
    "shares",
    "price_per_share"
  ],
  "properties": {
    "type": {
      "enum": [
        "buy",
        "sell"
      ],
      "type": "string",
      "description": "Trade type"
    },
    "notes": {
      "type": "string",
      "description": "Trade notes"
    },
    "shares": {
      "type": "number",
      "description": "Number of shares"
    },
    "traded_at": {
      "type": "string",
      "description": "Trade date (Y-m-d, defaults to now)"
    },
    "holding_id": {
      "type": "integer",
      "description": "Holding ID"
    },
    "price_per_share": {
      "type": "number",
      "description": "Price per share"
    }
  }
}

add_transaction

Add a financial transaction (income or expense) to an account with optional category.

Argument	Type	Description
type*	string	Transaction type
notes	string	Additional notes
amount*	number	Transaction amount (positive number)
account_id	integer	Account ID (see list_accounts). Defaults to the user's main account.
category_id	integer	Category ID
description*	string	What is this transaction for
transaction_date	string	Date (Y-m-d, defaults to today)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "amount",
    "type",
    "description"
  ],
  "properties": {
    "type": {
      "enum": [
        "income",
        "expense",
        "transfer"
      ],
      "type": "string",
      "description": "Transaction type"
    },
    "notes": {
      "type": "string",
      "description": "Additional notes"
    },
    "amount": {
      "type": "number",
      "description": "Transaction amount (positive number)"
    },
    "account_id": {
      "type": "integer",
      "description": "Account ID (see list_accounts). Defaults to the user's main account."
    },
    "category_id": {
      "type": "integer",
      "description": "Category ID"
    },
    "description": {
      "type": "string",
      "description": "What is this transaction for"
    },
    "transaction_date": {
      "type": "string",
      "description": "Date (Y-m-d, defaults to today)"
    }
  }
}

add_user_memory

Add a personal fact to the user's AI memory. Keep it concise (1-2 sentences). Max 50 memories per user.

Argument	Type	Description
content*	string	The memory content (max 500 chars, 1-2 sentences)
category	string	Memory category

Input schema (JSON)

{
  "type": "object",
  "required": [
    "content"
  ],
  "properties": {
    "content": {
      "type": "string",
      "description": "The memory content (max 500 chars, 1-2 sentences)"
    },
    "category": {
      "enum": [
        "personal",
        "career",
        "lifestyle",
        "values",
        "finance",
        "random"
      ],
      "type": "string",
      "description": "Memory category"
    }
  }
}

add_wishlist_item

Add an item to the wishlist with price range, priority, and optional URL.

Argument	Type	Description
url	string	Product URL
name*	string	Item name
notes	string	Notes
category	string	Category
currency	string	3-letter currency code, e.g. GBP. Defaults to the user's currency
priority	string	Priority
price_max	number	Maximum price
price_min	number	Minimum price
description	string	Description

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Product URL"
    },
    "name": {
      "type": "string",
      "description": "Item name"
    },
    "notes": {
      "type": "string",
      "description": "Notes"
    },
    "category": {
      "type": "string",
      "description": "Category"
    },
    "currency": {
      "type": "string",
      "description": "3-letter currency code, e.g. GBP. Defaults to the user's currency"
    },
    "priority": {
      "enum": [
        "high",
        "medium",
        "low",
        "waiting"
      ],
      "type": "string",
      "description": "Priority"
    },
    "price_max": {
      "type": "number",
      "description": "Maximum price"
    },
    "price_min": {
      "type": "number",
      "description": "Minimum price"
    },
    "description": {
      "type": "string",
      "description": "Description"
    }
  }
}

compare_analytics_periods

Compare two date periods for a project. Shows SC and GA metrics for both periods with percentage changes. Use for week-over-week, month-over-month comparisons, measuring campaign impact, tracking growth/decline.

read-only

Argument	Type	Description
project_id*	integer	Project ID (required)
current_end	string	Current period end (Y-m-d). Default: today
previous_end	string	Previous period end (Y-m-d). Default: 7 days ago
current_start	string	Current period start (Y-m-d). Default: 7 days ago
previous_start	string	Previous period start (Y-m-d). Default: 14 days ago

Input schema (JSON)

{
  "type": "object",
  "required": [
    "project_id"
  ],
  "properties": {
    "project_id": {
      "type": "integer",
      "description": "Project ID (required)"
    },
    "current_end": {
      "type": "string",
      "description": "Current period end (Y-m-d). Default: today"
    },
    "previous_end": {
      "type": "string",
      "description": "Previous period end (Y-m-d). Default: 7 days ago"
    },
    "current_start": {
      "type": "string",
      "description": "Current period start (Y-m-d). Default: 7 days ago"
    },
    "previous_start": {
      "type": "string",
      "description": "Previous period start (Y-m-d). Default: 14 days ago"
    }
  }
}

complete_task

Toggle a task between completed and pending. Cascades to subtasks and handles recurrence.

Argument	Type	Description
task_id*	integer	ID of the task to complete/uncomplete

Input schema (JSON)

{
  "type": "object",
  "required": [
    "task_id"
  ],
  "properties": {
    "task_id": {
      "type": "integer",
      "description": "ID of the task to complete/uncomplete"
    }
  }
}

create_book

Add a book to your library. Set status to "reading", "wishlist", "to_check", etc.

Argument	Type	Description
tags	array	Tags
notes	string	Personal notes about the book
pages	integer	Total pages
title*	string	Book title
author	string	Author name
rating	integer	Rating 1-5
status	string	Reading status

Input schema (JSON)

{
  "type": "object",
  "required": [
    "title"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tags"
    },
    "notes": {
      "type": "string",
      "description": "Personal notes about the book"
    },
    "pages": {
      "type": "integer",
      "description": "Total pages"
    },
    "title": {
      "type": "string",
      "description": "Book title"
    },
    "author": {
      "type": "string",
      "description": "Author name"
    },
    "rating": {
      "enum": [
        1,
        2,
        3,
        4,
        5
      ],
      "type": "integer",
      "description": "Rating 1-5"
    },
    "status": {
      "enum": [
        "wishlist",
        "reading",
        "to_check",
        "completed",
        "abandoned"
      ],
      "type": "string",
      "description": "Reading status"
    }
  }
}

create_contact

Create a new contact (personal CRM). Track birthdays, relationship types, and contact frequency reminders.

Argument	Type	Description
city	string	City/location
tags	array	Tags array, e.g. ["investor", "design"]
email	string	Email address
notes	string	Notes about this person
phone	string	Phone number
company	string	Company/organization
birthday	string	Birthday (Y-m-d). Year unknown: use 1604 as the year
last_name	string	Last name
first_name*	string	First name
how_we_met	string	How you met this person
project_id	integer	Link to project by ID

create_goal

Create a new goal. Types: milestone (checklist), numeric (value tracking), habit, vision.

Argument	Type	Description
unit	string	Unit of measurement (for numeric goals)
title*	string	Goal title
category	string	Category (e.g., Health, Career, Finance)
priority	integer	Priority: 1=high, 2=medium, 3=low
goal_type	string	Type
milestones	array	Milestones array [{title: "..."}] (for milestone goals)
description	string	Goal description
start_value	number	Starting value; defaults to current_value. Lets goals that go down (90 -> 80 kg) show progress
target_date	string	Target date (Y-m-d)
current_value	number	Current value (numeric goals, >= 0)

create_habit

Create a new habit. Tracking types: check (daily toggle), count (hit a number), duration (minutes), times_per_week (weekly frequency).

Argument	Type	Description
icon	string	Lucide icon name (lowercase, dashes), e.g. book-open
name*	string	Habit name
unit	string	Unit label (e.g., "pages", "glasses")
color	string	Color as #rrggbb, e.g. #10AC84
time_of_day	string	When during the day
target_value	integer	Target count value (for count type)
tracking_type	string	Tracking type (default: check)
times_per_week	integer	Times per week target (for times_per_week type, 1-7)
target_duration	integer	Target duration in minutes (for duration type, 5-480)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "icon": {
      "type": "string",
      "description": "Lucide icon name (lowercase, dashes), e.g. book-open"
    },
    "name": {
      "type": "string",
      "description": "Habit name"
    },
    "unit": {
      "type": "string",
      "description": "Unit label (e.g., \"pages\", \"glasses\")"
    },
    "color": {
      "type": "string",
      "description": "Color as #rrggbb, e.g. #10AC84"
    },
    "time_of_day": {
      "enum": [
        "morning",
        "afternoon",
        "evening"
      ],
      "type": "string",
      "description": "When during the day"
    },
    "target_value": {
      "type": "integer",
      "description": "Target count value (for count type)"
    },
    "tracking_type": {
      "enum": [
        "check",
        "count",
        "duration",
        "times_per_week"
      ],
      "type": "string",
      "description": "Tracking type (default: check)"
    },
    "times_per_week": {
      "type": "integer",
      "description": "Times per week target (for times_per_week type, 1-7)"
    },
    "target_duration": {
      "type": "integer",
      "description": "Target duration in minutes (for duration type, 5-480)"
    }
  }
}

create_note

Create a new note with title, body text, and optional tags.

Argument	Type	Description
body*	string	Note body (plain text)
tags	array	Tags array
title*	string	Note title
is_pinned	boolean	Pin this note
project_id	integer	Link to project by ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "title",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Note body (plain text)"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tags array"
    },
    "title": {
      "type": "string",
      "description": "Note title"
    },
    "is_pinned": {
      "type": "boolean",
      "description": "Pin this note"
    },
    "project_id": {
      "type": "integer",
      "description": "Link to project by ID"
    }
  }
}

create_project

Create a new project with tier (A/B/C), optional goal link, and target date.

Argument	Type	Description
url	string	Project URL
icon	string	Lucide icon name
name*	string	Project name
tier	string	Priority tier
color	string	Color hex code (e.g., #3B82F6)
status	string	Initial status
goal_id	integer	Link to a goal by ID
description	string	Project description
target_date	string	Target completion date (Y-m-d)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Project URL"
    },
    "icon": {
      "type": "string",
      "description": "Lucide icon name"
    },
    "name": {
      "type": "string",
      "description": "Project name"
    },
    "tier": {
      "enum": [
        "A",
        "B",
        "C"
      ],
      "type": "string",
      "description": "Priority tier"
    },
    "color": {
      "type": "string",
      "description": "Color hex code (e.g., #3B82F6)"
    },
    "status": {
      "enum": [
        "active",
        "paused"
      ],
      "type": "string",
      "description": "Initial status"
    },
    "goal_id": {
      "type": "integer",
      "description": "Link to a goal by ID"
    },
    "description": {
      "type": "string",
      "description": "Project description"
    },
    "target_date": {
      "type": "string",
      "description": "Target completion date (Y-m-d)"
    }
  }
}

create_quote

Save a quote with author and optional book link.

Argument	Type	Description
body*	string	The quote text
tags	array	Tags
author	string	Who said/wrote it
source	string	Source (book title, speech, etc.)
book_id	integer	Link to a book by ID
is_favorite	boolean	Mark as favorite

Input schema (JSON)

{
  "type": "object",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "The quote text"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tags"
    },
    "author": {
      "type": "string",
      "description": "Who said/wrote it"
    },
    "source": {
      "type": "string",
      "description": "Source (book title, speech, etc.)"
    },
    "book_id": {
      "type": "integer",
      "description": "Link to a book by ID"
    },
    "is_favorite": {
      "type": "boolean",
      "description": "Mark as favorite"
    }
  }
}

create_subscription

Add a recurring subscription (monthly, yearly, or weekly).

Argument	Type	Description
url	string	Service URL (http or https)
name*	string	Subscription name (e.g., Netflix, Spotify)
notes	string	Notes
amount*	number	Amount per billing period
currency	string	ISO 4217 currency code, e.g. USD, EUR, GBP. Defaults to the user's currency.
frequency	string	Billing frequency
category_id	integer	Category ID
next_billing_date	string	Next billing date (Y-m-d)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name",
    "amount"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Service URL (http or https)"
    },
    "name": {
      "type": "string",
      "description": "Subscription name (e.g., Netflix, Spotify)"
    },
    "notes": {
      "type": "string",
      "description": "Notes"
    },
    "amount": {
      "type": "number",
      "description": "Amount per billing period"
    },
    "currency": {
      "type": "string",
      "description": "ISO 4217 currency code, e.g. USD, EUR, GBP. Defaults to the user's currency."
    },
    "frequency": {
      "enum": [
        "monthly",
        "quarterly",
        "yearly",
        "weekly"
      ],
      "type": "string",
      "description": "Billing frequency"
    },
    "category_id": {
      "type": "integer",
      "description": "Category ID"
    },
    "next_billing_date": {
      "type": "string",
      "description": "Next billing date (Y-m-d)"
    }
  }
}

create_task

Create a new task with optional project, priority, due date, and recurrence.

Argument	Type	Description
title*	string	Task title
status	string	Initial status
is_top3	boolean	Mark as Top 3 focus task (max 3 allowed)
due_date	string	Due date (Y-m-d format)
priority	integer	Priority: 1=high, 2=medium, 3=low
project_id	integer	Assign to project by ID
recurrence	string	Recurrence pattern
description	string	Task description

Input schema (JSON)

{
  "type": "object",
  "required": [
    "title"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Task title"
    },
    "status": {
      "enum": [
        "pending",
        "in_progress"
      ],
      "type": "string",
      "description": "Initial status"
    },
    "is_top3": {
      "type": "boolean",
      "description": "Mark as Top 3 focus task (max 3 allowed)"
    },
    "due_date": {
      "type": "string",
      "description": "Due date (Y-m-d format)"
    },
    "priority": {
      "enum": [
        1,
        2,
        3
      ],
      "type": "integer",
      "description": "Priority: 1=high, 2=medium, 3=low"
    },
    "project_id": {
      "type": "integer",
      "description": "Assign to project by ID"
    },
    "recurrence": {
      "enum": [
        "daily",
        "weekly",
        "monthly"
      ],
      "type": "string",
      "description": "Recurrence pattern"
    },
    "description": {
      "type": "string",
      "description": "Task description"
    }
  }
}

delete_body_measurement

Delete a body measurement that was logged by mistake. Two entries on one date drag the weight trend and the waist rule, so a bad one is worth removing rather than logging over.

destructive

Argument	Type	Description
measured_at	string	Delete every measurement on this date (Y-m-d)
measurement_id	integer	Id of the measurement to delete

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "measured_at": {
      "type": "string",
      "description": "Delete every measurement on this date (Y-m-d)"
    },
    "measurement_id": {
      "type": "integer",
      "description": "Id of the measurement to delete"
    }
  }
}

delete_book

Delete a book from the library.

destructive

Argument	Type	Description
book_id*	integer	ID of the book to delete

Input schema (JSON)

{
  "type": "object",
  "required": [
    "book_id"
  ],
  "properties": {
    "book_id": {
      "type": "integer",
      "description": "ID of the book to delete"
    }
  }
}

delete_bookmark

Delete a bookmark permanently.

destructive

Argument	Type	Description
bookmark_id*	integer	ID of the bookmark to delete

Input schema (JSON)

{
  "type": "object",
  "required": [
    "bookmark_id"
  ],
  "properties": {
    "bookmark_id": {
      "type": "integer",
      "description": "ID of the bookmark to delete"
    }
  }
}

delete_note

Soft-delete a note.

destructive

Argument	Type	Description
note_id*	integer	ID of the note to delete

Input schema (JSON)

{
  "type": "object",
  "required": [
    "note_id"
  ],
  "properties": {
    "note_id": {
      "type": "integer",
      "description": "ID of the note to delete"
    }
  }
}

delete_task

Soft-delete a task (can be restored later).

destructive

Argument	Type	Description
task_id*	integer	ID of the task to delete

Input schema (JSON)

{
  "type": "object",
  "required": [
    "task_id"
  ],
  "properties": {
    "task_id": {
      "type": "integer",
      "description": "ID of the task to delete"
    }
  }
}

delete_user_memory

Delete a specific AI memory entry by ID.

destructive

Argument	Type	Description
id*	integer	ID of the memory to delete

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "ID of the memory to delete"
    }
  }
}

delete_workout

Delete a whole training session and every set in it. To remove only part of a session use delete_workout_sets.

destructive

Argument	Type	Description
type	string	Narrow to one session type on that date
workout_id	integer	Session id — required only when a date carries more than one session
workout_date	string	Session date (Y-m-d, defaults to today)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "type": {
      "enum": [
        "push",
        "pull",
        "legs",
        "upper",
        "lower",
        "full_body",
        "zone2",
        "cardio",
        "other"
      ],
      "type": "string",
      "description": "Narrow to one session type on that date"
    },
    "workout_id": {
      "type": "integer",
      "description": "Session id — required only when a date carries more than one session"
    },
    "workout_date": {
      "type": "string",
      "description": "Session date (Y-m-d, defaults to today)"
    }
  }
}

delete_workout_sets

Remove sets from a session without touching the session itself. Use duplicates_only to undo a log that was sent twice, or exercise to drop one movement that was entered by mistake.

destructive

Argument	Type	Description
exercise	string	Remove every set of this movement from the session, e.g. "leg press"
workout_id	integer	Session id — required only when a date carries more than one session
workout_date	string	Session date (Y-m-d, defaults to today)
duplicates_only	boolean	Remove blocks that repeat an identical earlier block in the same session — the fix for a log sent twice. Keeps the first occurrence.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "exercise": {
      "type": "string",
      "description": "Remove every set of this movement from the session, e.g. \"leg press\""
    },
    "workout_id": {
      "type": "integer",
      "description": "Session id — required only when a date carries more than one session"
    },
    "workout_date": {
      "type": "string",
      "description": "Session date (Y-m-d, defaults to today)"
    },
    "duplicates_only": {
      "type": "boolean",
      "description": "Remove blocks that repeat an identical earlier block in the same session — the fix for a log sent twice. Keeps the first occurrence."
    }
  }
}

get_daily_entry

Get the daily journal entry for a date: mood, energy, focus, morning/evening notes.

read-only

Argument	Type	Description
date	string	Date to get (Y-m-d, defaults to today)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "Date to get (Y-m-d, defaults to today)"
    }
  }
}

get_fitness_summary

Current fitness state: weight trend vs target rate, waist thresholds, nutrition averages vs macro targets, training frequency and volume, plus which days are missing data.

read-only

Argument	Type	Description
training_days	integer	Training window in days (default 28)
nutrition_days	integer	Nutrition averaging window in days (default 7)
include_training_grid	boolean	Add the movement-by-session grid — what was lifted last time and whether it went up. Use it before advising on a session.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "training_days": {
      "type": "integer",
      "description": "Training window in days (default 28)"
    },
    "nutrition_days": {
      "type": "integer",
      "description": "Nutrition averaging window in days (default 7)"
    },
    "include_training_grid": {
      "type": "boolean",
      "description": "Add the movement-by-session grid — what was lifted last time and whether it went up. Use it before advising on a session."
    }
  }
}

get_focus_summary

Get focus time summary: total minutes, sessions, and breakdown by project for a date range.

read-only

Argument	Type	Description
to	string	End date (Y-m-d, defaults to today)
from	string	Start date (Y-m-d, defaults to start of current week)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "to": {
      "type": "string",
      "description": "End date (Y-m-d, defaults to today)"
    },
    "from": {
      "type": "string",
      "description": "Start date (Y-m-d, defaults to start of current week)"
    }
  }
}

get_project_analytics

Get daily Search Console + GA4 metrics for a project. Returns clicks, impressions, CTR, position, sessions, users, pageviews, bounce rate per day. Use for trend analysis, performance reports, comparing periods.

read-only

Argument	Type	Description
end_date	string	End date (Y-m-d). Default: today
project_id*	integer	Project ID (required)
start_date	string	Start date (Y-m-d). Default: 30 days ago

Input schema (JSON)

{
  "type": "object",
  "required": [
    "project_id"
  ],
  "properties": {
    "end_date": {
      "type": "string",
      "description": "End date (Y-m-d). Default: today"
    },
    "project_id": {
      "type": "integer",
      "description": "Project ID (required)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (Y-m-d). Default: 30 days ago"
    }
  }
}

get_top_pages

Get top performing pages for a project from Search Console data. Returns page URL, total clicks, impressions, avg CTR, avg position. Use for content performance analysis, finding underperforming pages, identifying top content.

read-only

Argument	Type	Description
limit	integer	Max results (default 100, max 500)
search	string	Filter pages containing this URL path
sort_by	string	Sort by metric
end_date	string	End date (Y-m-d). Default: today
project_id*	integer	Project ID (required)
start_date	string	Start date (Y-m-d). Default: 30 days ago

Input schema (JSON)

{
  "type": "object",
  "required": [
    "project_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max results (default 100, max 500)"
    },
    "search": {
      "type": "string",
      "description": "Filter pages containing this URL path"
    },
    "sort_by": {
      "enum": [
        "clicks",
        "impressions",
        "ctr",
        "position"
      ],
      "type": "string",
      "description": "Sort by metric"
    },
    "end_date": {
      "type": "string",
      "description": "End date (Y-m-d). Default: today"
    },
    "project_id": {
      "type": "integer",
      "description": "Project ID (required)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (Y-m-d). Default: 30 days ago"
    }
  }
}

get_top_queries

Get top search queries for a project from Search Console data. Returns query text, total clicks, impressions, avg CTR, avg position. Use for keyword analysis, content strategy, SEO optimization, finding ranking opportunities.

read-only

Argument	Type	Description
limit	integer	Max results (default 100, max 500)
search	string	Filter queries containing this text
sort_by	string	Sort by metric
end_date	string	End date (Y-m-d). Default: today
min_clicks	integer	Minimum clicks filter
project_id*	integer	Project ID (required)
start_date	string	Start date (Y-m-d). Default: 30 days ago
min_impressions	integer	Minimum impressions filter

Input schema (JSON)

{
  "type": "object",
  "required": [
    "project_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max results (default 100, max 500)"
    },
    "search": {
      "type": "string",
      "description": "Filter queries containing this text"
    },
    "sort_by": {
      "enum": [
        "clicks",
        "impressions",
        "ctr",
        "position"
      ],
      "type": "string",
      "description": "Sort by metric"
    },
    "end_date": {
      "type": "string",
      "description": "End date (Y-m-d). Default: today"
    },
    "min_clicks": {
      "type": "integer",
      "description": "Minimum clicks filter"
    },
    "project_id": {
      "type": "integer",
      "description": "Project ID (required)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (Y-m-d). Default: 30 days ago"
    },
    "min_impressions": {
      "type": "integer",
      "description": "Minimum impressions filter"
    }
  }
}

get_user_memories

Get the user's AI memory entries — personal facts, preferences, and context that personalize AI responses.

read-only

Argument	Type	Description
category	string	Filter by category

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "category": {
      "enum": [
        "personal",
        "career",
        "lifestyle",
        "values",
        "finance",
        "random"
      ],
      "type": "string",
      "description": "Filter by category"
    }
  }
}

list_accounts

List financial accounts with balances and types.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_achievements

List all achievements: unlocked and locked, with descriptions and unlock dates.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_books

List books with optional status filter. Returns title, author, status, progress, and rating.

read-only

Argument	Type	Description
status	string	Filter by status

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "status": {
      "enum": [
        "wishlist",
        "reading",
        "to_check",
        "completed",
        "abandoned"
      ],
      "type": "string",
      "description": "Filter by status"
    }
  }
}

list_categories

List transaction categories with type (income/expense) and monthly budget.

read-only

Argument	Type	Description
type	string	Filter by type

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "type": {
      "enum": [
        "income",
        "expense",
        "both"
      ],
      "type": "string",
      "description": "Filter by type"
    }
  }
}

list_contacts

List contacts. Filter by relationship type or get contacts needing reach-out.

read-only

Argument	Type	Description
relationship	string	Filter by type
needs_contact	boolean	Only contacts overdue for check-in
favorites_only	boolean	Only favorite contacts

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "relationship": {
      "enum": [
        "family",
        "friend",
        "work",
        "mentor",
        "other"
      ],
      "type": "string",
      "description": "Filter by type"
    },
    "needs_contact": {
      "type": "boolean",
      "description": "Only contacts overdue for check-in"
    },
    "favorites_only": {
      "type": "boolean",
      "description": "Only favorite contacts"
    }
  }
}

list_exercises

The movement catalog: canonical names, muscle groups and the aliases that resolve to them. Check here before logging sets — using the catalog name keeps one lift on one row instead of splitting its history across near-duplicates.

read-only

Argument	Type	Description
search	string	Match against names and aliases
muscle_group	string	chest, back, shoulders, biceps, triceps, legs, core, cardio
trained_only	boolean	Only movements this user has actually logged sets for

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "search": {
      "type": "string",
      "description": "Match against names and aliases"
    },
    "muscle_group": {
      "type": "string",
      "description": "chest, back, shoulders, biceps, triceps, legs, core, cardio"
    },
    "trained_only": {
      "type": "boolean",
      "description": "Only movements this user has actually logged sets for"
    }
  }
}

list_goals

List goals with progress, type, and status. Supports filtering by status or category.

read-only

Argument	Type	Description
status	string	Filter by status
category	string	Filter by category

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "status": {
      "enum": [
        "active",
        "paused",
        "completed",
        "abandoned"
      ],
      "type": "string",
      "description": "Filter by status"
    },
    "category": {
      "type": "string",
      "description": "Filter by category"
    }
  }
}

list_habits

List active habits with the value logged and done status for a date, plus current streaks. Streaks count from yesterday while today is still open; times_per_week habits have weekly streaks (streak_unit=weeks).

read-only

Argument	Type	Description
date	string	Date to check (Y-m-d, defaults to today)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "Date to check (Y-m-d, defaults to today)"
    }
  }
}

list_holdings

List portfolio holdings with market value, P/L, and allocation. Totals are in the user's currency; holdings without a live price are valued at cost and have null P/L.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_notes

List notes, optionally filtered by search query or tag. Returns title, tags, and truncated body.

read-only

Argument	Type	Description
tag	string	Filter by tag name
limit	integer	Max results (default: 20, max: 50)
search	string	Search query (matches title and body)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "tag": {
      "type": "string",
      "description": "Filter by tag name"
    },
    "limit": {
      "type": "integer",
      "description": "Max results (default: 20, max: 50)"
    },
    "search": {
      "type": "string",
      "description": "Search query (matches title and body)"
    }
  }
}

list_projects

List projects with task counts, tier, status, and linked goal.

read-only

Argument	Type	Description
tier	string	Filter by tier
status	string	Filter by status. Archived projects are excluded unless you ask for them explicitly.
include_archived	boolean	Include archived projects in an unfiltered list (default: false)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "tier": {
      "enum": [
        "A",
        "B",
        "C"
      ],
      "type": "string",
      "description": "Filter by tier"
    },
    "status": {
      "enum": [
        "active",
        "paused",
        "completed",
        "archived"
      ],
      "type": "string",
      "description": "Filter by status. Archived projects are excluded unless you ask for them explicitly."
    },
    "include_archived": {
      "type": "boolean",
      "description": "Include archived projects in an unfiltered list (default: false)"
    }
  }
}

list_quotes

List saved quotes, optionally filtered by book or favorites only.

read-only

Argument	Type	Description
book_id	integer	Filter by book ID
favorites_only	boolean	Only show favorites

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "book_id": {
      "type": "integer",
      "description": "Filter by book ID"
    },
    "favorites_only": {
      "type": "boolean",
      "description": "Only show favorites"
    }
  }
}

list_subscriptions

List active subscriptions with amounts, frequency, and next billing date.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_tasks

List tasks, optionally filtered by status, priority, project, or top3 flag.

read-only

Argument	Type	Description
status	string	Filter by status
is_top3	boolean	Only show Top 3 focus tasks
priority	integer	Filter by priority: 1=high, 2=medium, 3=low
project_id	integer	Filter by project ID
include_archived	boolean	Include archived tasks (default: false)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "status": {
      "enum": [
        "pending",
        "in_progress",
        "completed"
      ],
      "type": "string",
      "description": "Filter by status"
    },
    "is_top3": {
      "type": "boolean",
      "description": "Only show Top 3 focus tasks"
    },
    "priority": {
      "enum": [
        1,
        2,
        3
      ],
      "type": "integer",
      "description": "Filter by priority: 1=high, 2=medium, 3=low"
    },
    "project_id": {
      "type": "integer",
      "description": "Filter by project ID"
    },
    "include_archived": {
      "type": "boolean",
      "description": "Include archived tasks (default: false)"
    }
  }
}

list_wishlist

List wishlist items with price, priority, and purchase status.

read-only

Argument	Type	Description
status	string	Filter by status (default: pending)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "status": {
      "enum": [
        "pending",
        "purchased",
        "cancelled"
      ],
      "type": "string",
      "description": "Filter by status (default: pending)"
    }
  }
}

log_body_measurement

Log body measurements: weight, body fat %, waist, chest, etc.

Argument	Type	Description
hips	number	Hips circumference in cm
neck	number	Neck circumference in cm
chest	number	Chest circumference in cm
notes	string	Notes
waist	number	Natural waist (narrowest point) in cm — the primary trend metric
vo2max	number	VO2 max
weight	number	Weight in kg
body_fat	number	Body fat percentage
left_arm	number	Left arm circumference in cm
left_quad	number	Left quad circumference in cm
right_arm	number	Right arm circumference in cm

log_focus_session

Log a completed focus/pomodoro session with duration, project, and task link.

Argument	Type	Description
type	string	Session type
label	string	Session label/name
task_id	integer	Link to task
project_id	integer	Link to project
started_at	string	When it started (Y-m-d H:i, defaults to now minus duration)
duration_minutes*	integer	Session duration in minutes

Input schema (JSON)

{
  "type": "object",
  "required": [
    "duration_minutes"
  ],
  "properties": {
    "type": {
      "enum": [
        "pomodoro",
        "timer"
      ],
      "type": "string",
      "description": "Session type"
    },
    "label": {
      "type": "string",
      "description": "Session label/name"
    },
    "task_id": {
      "type": "integer",
      "description": "Link to task"
    },
    "project_id": {
      "type": "integer",
      "description": "Link to project"
    },
    "started_at": {
      "type": "string",
      "description": "When it started (Y-m-d H:i, defaults to now minus duration)"
    },
    "duration_minutes": {
      "type": "integer",
      "description": "Session duration in minutes"
    }
  }
}

log_habit

Log a habit entry for a date. Sets the value for a day (0 clears it). Without a value the day is marked fully done.

Argument	Type	Description
date	string	Date to log (Y-m-d, defaults to today, cannot be in the future)
value	number	Value to set for that day (default: the habit's full daily target, i.e. done). 0 clears the day. Count/duration habits are only done when value >= target.
habit_id*	integer	ID of the habit

Input schema (JSON)

{
  "type": "object",
  "required": [
    "habit_id"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Date to log (Y-m-d, defaults to today, cannot be in the future)"
    },
    "value": {
      "type": "number",
      "description": "Value to set for that day (default: the habit's full daily target, i.e. done). 0 clears the day. Count/duration habits are only done when value >= target."
    },
    "habit_id": {
      "type": "integer",
      "description": "ID of the habit"
    }
  }
}

log_nutrition

Log a day of nutrition — day totals plus optional food-by-food line items. Re-sending the same date replaces that day.

Argument	Type	Description
fat_g	integer	Total fat in grams
notes	string	Notes
carbs_g	integer	Total carbs in grams
entries	array	Food-by-food line items. Each: {name, calories, protein_g, carbs_g, fat_g, fiber_g, sugar_g, sodium_mg, consumed_at "HH:MM"}
fiber_g	integer	Total fiber in grams
sugar_g	integer	Total sugar in grams
calories	integer	Total calories for the day
log_date*	string	Date (Y-m-d)
protein_g	integer	Total protein in grams
sodium_mg	integer	Total sodium in mg
is_complete

log_workout

Log a workout session with type, duration, calories, and heart rate.

Argument	Type	Description
type*	string	Workout type
notes	string	Notes
avg_hr	integer	Average heart rate
max_hr	integer	Max heart rate
min_hr	integer	Min heart rate
calories	integer	Total calories burned
ended_at	string	Session end (Y-m-d H:i:s)
location	string	Where the session happened
started_at	string	Session start (Y-m-d H:i:s)
workout_date	string	Workout date (Y-m-d, defaults to today)
active_calories	integer	Active calories (Apple Watch)

log_workout_sets

Add exercises and sets to a workout. Accepts gym shorthand ("lateral raise 5kg 4x12", "2min rowing machine") and creates the workout for that date if none exists.

Argument	Type	Description
type	string	Workout type. Sets go to the session of this type on that date; a new session is created when there is none.
notes	string	Notes
sets_text*	string	One movement per line. Understands "4x12", "40kg", "2dk"/"90sn", "3 set". Example: "lateral raise 5kg 4x12\nincline bench press machine 40kg 4x8"
workout_id	integer	Add to this session. Needed when the date holds more than one session of the same type.
workout_date	string	Date (Y-m-d, defaults to today)
allow_duplicates	boolean	Write blocks that already exist on that date with the same load and set count. Off by default — a repeated call is far more often a re-send than a second round.
duration_minutes	integer	Session duration in minutes

Input schema (JSON)

{
  "type": "object",
  "required": [
    "sets_text"
  ],
  "properties": {
    "type": {
      "enum": [
        "push",
        "pull",
        "legs",
        "upper",
        "lower",
        "full_body",
        "zone2",
        "cardio",
        "other"
      ],
      "type": "string",
      "description": "Workout type. Sets go to the session of this type on that date; a new session is created when there is none."
    },
    "notes": {
      "type": "string",
      "description": "Notes"
    },
    "sets_text": {
      "type": "string",
      "description": "One movement per line. Understands \"4x12\", \"40kg\", \"2dk\"/\"90sn\", \"3 set\". Example: \"lateral raise 5kg 4x12\\nincline bench press machine 40kg 4x8\""
    },
    "workout_id": {
      "type": "integer",
      "description": "Add to this session. Needed when the date holds more than one session of the same type."
    },
    "workout_date": {
      "type": "string",
      "description": "Date (Y-m-d, defaults to today)"
    },
    "allow_duplicates": {
      "type": "boolean",
      "description": "Write blocks that already exist on that date with the same load and set count. Off by default — a repeated call is far more often a re-send than a second round."
    },
    "duration_minutes": {
      "type": "integer",
      "description": "Session duration in minutes"
    }
  }
}

Search the user's Framezone data by keyword: tasks, projects, notes, bookmarks, books and goals.

read-only

Argument	Type	Description
query*	string	Search query (min 2 characters)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "description": "Search query (min 2 characters)"
    }
  }
}

update_book

Update a book: change status, rating, notes, or update reading progress (current page).

Argument	Type	Description
tags	array	Tags
notes	string	Personal notes
title	string	New title
author	string	New author
rating	integer	Rating 1-5
status	string	New status
book_id*	integer	Book ID
current_page	integer	Current page (updates reading progress)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "book_id"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tags"
    },
    "notes": {
      "type": "string",
      "description": "Personal notes"
    },
    "title": {
      "type": "string",
      "description": "New title"
    },
    "author": {
      "type": "string",
      "description": "New author"
    },
    "rating": {
      "enum": [
        1,
        2,
        3,
        4,
        5
      ],
      "type": "integer",
      "description": "Rating 1-5"
    },
    "status": {
      "enum": [
        "wishlist",
        "reading",
        "to_check",
        "completed",
        "abandoned"
      ],
      "type": "string",
      "description": "New status"
    },
    "book_id": {
      "type": "integer",
      "description": "Book ID"
    },
    "current_page": {
      "type": "integer",
      "description": "Current page (updates reading progress)"
    }
  }
}

update_contact

Update a contact. Use mark_contacted=true to record a check-in with today's date.

Argument	Type	Description
id*	integer	Contact ID
name	string	Full name; split into first and last name at the first space
email	string	Email
notes	string	Notes
phone	string	Phone
company	string	Company
birthday	string	Birthday (Y-m-d). Year unknown: use 1604 as the year
last_name	string	Last name (empty string clears it)
first_name	string	First name
is_favorite	boolean	Favorite status
relationship	string	Type

update_daily_entry

Update the daily journal: set mood (1-5), energy (1-5), focus text, morning/evening notes.

Argument	Type	Description
date	string	Date to update (Y-m-d, defaults to today)
mood	integer	Mood rating 1-5
energy	integer	Energy rating 1-5
focus_text	string	Today's focus/intention text (max 255 characters)
evening_note	string	Evening reflection note
morning_note	string	Morning journal note
focus_completed	boolean	Whether the focus was achieved

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "Date to update (Y-m-d, defaults to today)"
    },
    "mood": {
      "enum": [
        1,
        2,
        3,
        4,
        5
      ],
      "type": "integer",
      "description": "Mood rating 1-5"
    },
    "energy": {
      "enum": [
        1,
        2,
        3,
        4,
        5
      ],
      "type": "integer",
      "description": "Energy rating 1-5"
    },
    "focus_text": {
      "type": "string",
      "description": "Today's focus/intention text (max 255 characters)"
    },
    "evening_note": {
      "type": "string",
      "description": "Evening reflection note"
    },
    "morning_note": {
      "type": "string",
      "description": "Morning journal note"
    },
    "focus_completed": {
      "type": "boolean",
      "description": "Whether the focus was achieved"
    }
  }
}

update_goal

Update a goal: change status, progress, toggle milestones, or add a progress note.

Argument	Type	Description
note	string	Progress update note (saved in goal timeline)
title	string	New title
status	string	New status
goal_id*	integer	Goal ID
priority	integer	Priority: 1=high, 2=medium, 3=low
description	string	New description
start_value	number	Value the goal started from; progress is measured from it (use for goals that go down, e.g. 90 -> 80 kg)
target_date	string	New target date (Y-m-d)
current_value	number	Current value (for numeric goals, >= 0)
target_value_num	number	Target value (numeric and habit goals)

update_habit

Update an existing habit. Only provided fields are changed.

Argument	Type	Description
icon	string	Lucide icon name (lowercase, dashes), e.g. book-open
name	string	New habit name
unit	string	New unit label
color	string	Color as #rrggbb, e.g. #10AC84
active	boolean	Enable or disable the habit
habit_id*	integer	ID of the habit to update
time_of_day	string	When during the day
target_value	integer	New target count value
tracking_type	string	New tracking type
times_per_week	integer	New times per week target (1-7)
target_duration	integer

update_project

Update a project: change name, tier, status, goal link, or target date.

Argument	Type	Description
url	string	Project URL
icon	string	Lucide icon name
name	string	New name
tier	string	New tier
color	string	Color hex
status	string	New status
goal_id	integer	Link to goal by ID (0 to unlink)
project_id*	integer	Project ID
description	string	New description
target_date	string	Target date (Y-m-d)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "project_id"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Project URL"
    },
    "icon": {
      "type": "string",
      "description": "Lucide icon name"
    },
    "name": {
      "type": "string",
      "description": "New name"
    },
    "tier": {
      "enum": [
        "A",
        "B",
        "C"
      ],
      "type": "string",
      "description": "New tier"
    },
    "color": {
      "type": "string",
      "description": "Color hex"
    },
    "status": {
      "enum": [
        "active",
        "paused",
        "completed",
        "archived"
      ],
      "type": "string",
      "description": "New status"
    },
    "goal_id": {
      "type": "integer",
      "description": "Link to goal by ID (0 to unlink)"
    },
    "project_id": {
      "type": "integer",
      "description": "Project ID"
    },
    "description": {
      "type": "string",
      "description": "New description"
    },
    "target_date": {
      "type": "string",
      "description": "Target date (Y-m-d)"
    }
  }
}

update_task

Update an existing task. Only provided fields are changed.

Argument	Type	Description
title	string	New title
status	string	New status
is_top3	boolean	Set Top 3 status
task_id*	integer	ID of the task to update
due_date	string	New due date (Y-m-d)
priority	integer	Priority: 1=high, 2=medium, 3=low
project_id	integer	Assign to project by ID
description	string	New description

Input schema (JSON)

{
  "type": "object",
  "required": [
    "task_id"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "New title"
    },
    "status": {
      "enum": [
        "pending",
        "in_progress"
      ],
      "type": "string",
      "description": "New status"
    },
    "is_top3": {
      "type": "boolean",
      "description": "Set Top 3 status"
    },
    "task_id": {
      "type": "integer",
      "description": "ID of the task to update"
    },
    "due_date": {
      "type": "string",
      "description": "New due date (Y-m-d)"
    },
    "priority": {
      "enum": [
        1,
        2,
        3
      ],
      "type": "integer",
      "description": "Priority: 1=high, 2=medium, 3=low"
    },
    "project_id": {
      "type": "integer",
      "description": "Assign to project by ID"
    },
    "description": {
      "type": "string",
      "description": "New description"
    }
  }
}

update_wishlist_item

Update a wishlist item — mark it purchased or cancelled, change priority, price or notes. Purchased and cancelled items drop out of the active list.

Argument	Type	Description
url	string	Product URL (http or https)
name	string	New name
notes	string	Notes — reasoning, alternatives considered, purchase trigger
status	string	pending = still wanted · purchased = bought · cancelled = no longer wanted
item_id*	integer	Wishlist item ID
category	string	Category
currency	string	3-letter currency code of the prices, e.g. GBP
priority	string	high \| medium \| low \| waiting (waiting = wanted but gated on a trigger)
price_max	number	Upper price estimate
price_min	number	Lower price estimate

weekly_summary

Get a comprehensive weekly review: tasks, habits, mood/energy, portfolio, books, focus time.

read-only

Argument	Type	Description
week	string	ISO week format like "2026-W13" (defaults to current week)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "week": {
      "type": "string",
      "description": "ISO week format like \"2026-W13\" (defaults to current week)"
    }
  }
}