View Tools

Views are saved filter presets that let you quickly access a curated subset of thogits. Each view has a name, icon, filter, and optional settings.

create_view

Create a new saved view. The filter uses the same format as get_thogits search. Tag names in filters are automatically resolved to IDs on save.

Parameters

Name	Type	Required	Description
name	string	Yes	View name
icon	string	No	Emoji icon. Default: clipboard
filter	object	Yes	Thogit filter (same format as get_thogits search)
view_type	string	No	View type. Default: "list"
settings	object	No	Additional view settings

Example

// Request — create a view for high-priority open tasks
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_view",
    "arguments": {
      "name": "High Priority Tasks",
      "icon": "🔥",
      "filter": {
        "and": [
          { "has_tag": "Task" },
          { "Task.priority": { "gte": 7 } },
          { "not": { "Task.status": { "match": "done" } } }
        ]
      }
    }
  }
}

// Response
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"id\": \"01JEXAMPLE000000000000VIEW\",\n  \"name\": \"High Priority Tasks\",\n  \"icon\": \"🔥\",\n  \"filter\": { ... },\n  \"view_type\": \"list\",\n  \"settings\": {},\n  \"created_at\": \"2025-01-15T10:00:00Z\",\n  \"updated_at\": \"2025-01-15T10:00:00Z\"\n}"
      }
    ]
  }
}

---

get_view

Get a saved view by its ID.

Parameters

Name	Type	Required	Description
view_id	string	Yes	View ULID

Example

// Request
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_view",
    "arguments": {
      "view_id": "01JEXAMPLE000000000000VIEW"
    }
  }
}

// Response
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"id\": \"01JEXAMPLE000000000000VIEW\",\n  \"name\": \"High Priority Tasks\",\n  \"icon\": \"🔥\",\n  \"filter\": { ... },\n  \"view_type\": \"list\",\n  \"settings\": {}\n}"
      }
    ]
  }
}

---

list_views

List all saved views. No parameters required.

Parameters

None.

Example

// Request
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "list_views",
    "arguments": {}
  }
}

// Response
{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "[\n  {\n    \"id\": \"01JEXAMPLE000000000000VIEW\",\n    \"name\": \"High Priority Tasks\",\n    \"icon\": \"🔥\",\n    ...\n  },\n  {\n    \"id\": \"01JEXAMPLE00000000000VIEW2\",\n    \"name\": \"All Bugs\",\n    \"icon\": \"🐛\",\n    ...\n  }\n]"
      }
    ]
  }
}

---

update_view

Update a saved view’s name, icon, and filter. All fields are required when updating.

Parameters

Name	Type	Required	Description
view_id	string	Yes	View ULID
name	string	Yes	New name
icon	string	Yes	New emoji icon
filter	object	Yes	New filter
settings	object	No	Updated settings

Note

Unlike most update tools, update_view requires all fields (name, icon, filter). This is a full replacement, not a partial update.

Example

// Request — update the view to also include medium priority
{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "update_view",
    "arguments": {
      "view_id": "01JEXAMPLE000000000000VIEW",
      "name": "Priority Tasks",
      "icon": "⚡",
      "filter": {
        "and": [
          { "has_tag": "Task" },
          { "Task.priority": { "gte": 5 } },
          { "not": { "Task.status": { "match": "done" } } }
        ]
      }
    }
  }
}

// Response
{
  "jsonrpc": "2.0",
  "id": 4,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"ok\": true\n}"
      }
    ]
  }
}

---

delete_view

Delete a saved view by ID.

Parameters

Name	Type	Required	Description
view_id	string	Yes	View ULID

Example

// Request
{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "delete_view",
    "arguments": {
      "view_id": "01JEXAMPLE000000000000VIEW"
    }
  }
}

// Response
{
  "jsonrpc": "2.0",
  "id": 5,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"ok\": true\n}"
      }
    ]
  }
}