Skip to main content
Glama
likalg

Personal OS MCP

by likalg

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PERSONAL_OS_AI_TOKENYesAI token for authentication with Personal OS
PERSONAL_OS_BASE_URLNoBase URL of the Personal OS instancehttp://localhost:8080
PERSONAL_OS_MCP_TIMEOUT_SECONDSNoTimeout in seconds for MCP operations15

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
personal_os_healthA

Check authenticated Personal OS AI API availability without exposing sensitive data.

personal_os_capabilitiesA

Read the authoritative enums, filters, actions, limits, and lifecycle capabilities advertised by Personal OS.

personal_os_list_tasksA

List owned Tasks using only supported filters. Defaults to at most 100; maximum 200. Duration filters are total minutes: estimated_minutes for an exact match, min_estimated_minutes/max_estimated_minutes for a range (e.g. 'under 30 minutes' -> max_estimated_minutes: 30; 'one to two hours' -> min_estimated_minutes: 60, max_estimated_minutes: 120).

personal_os_get_taskA

Get one owned Task, including its current planning and lifecycle fields.

personal_os_create_taskA

Create one Task in an owned active non-Area Container, optionally replacing its complete Tag set.

personal_os_update_taskA

Partially update one owned active Task. Only supplied fields change; tag_ids replaces the complete Tag set.

personal_os_bulk_update_tasksA

CONFIRMATION REQUIRED. Atomically update 1-100 Tasks; one failure rolls back the entire batch.

personal_os_complete_taskB

Complete and archive this Task using the existing lifecycle.

personal_os_reopen_taskB

Reopen a completed Task and restore its previous status.

personal_os_archive_taskB

Archive this Task without completing it. It can be unarchived.

personal_os_unarchive_taskA

Restore a manually archived Task to active visibility.

personal_os_move_task_to_trashA

CONFIRMATION REQUIRED. Recoverable soft delete: move an active Task to Trash; this is not final deletion.

personal_os_restore_taskA

Restore an owned Task from Trash. This is Trash recovery, not archive restoration.

personal_os_update_task_planningA

Atomically update Task timeline and/or due information; Today/Tomorrow are resolved by Personal OS in the User timezone.

personal_os_list_tagsA

List active owned Tags in normalized display order.

personal_os_get_tagB

Get one owned Tag.

personal_os_create_tagA

Create a normalized owner-scoped Tag with optional description, emoji, and color. Case/whitespace-equivalent names are duplicates.

personal_os_update_tagA

Partially update an owned active Tag, including its optional description.

personal_os_archive_tagA

Archive a Tag while preserving existing associations. It can be restored.

personal_os_restore_tagB

Restore an archived Tag.

personal_os_delete_tagA

CONFIRMATION REQUIRED. Permanently and irreversibly delete a Tag; pivot assignments are removed.

personal_os_list_containersA

List the owned Container hierarchy grouped as Inbox, Areas/Projects, Collections, Reach Out, and Someday.

personal_os_get_containerA

Get one owned Container/List.

personal_os_create_containerC

Create a Container/List. Tasks may use Inbox, Project, Collection, Reach Out, or Someday; Area organizes Projects.

personal_os_update_containerB

Partially update an owned Container under existing hierarchy and Inbox restrictions.

personal_os_archive_containerB

Archive a Container under existing propagation and Inbox rules. It can be restored.

personal_os_restore_containerA

Restore an archived Container and applicable children.

personal_os_delete_containerA

CONFIRMATION REQUIRED. Permanently and irreversibly delete a Container after existing child/content/Inbox guards.

personal_os_list_projectsA

List active owned Projects. Project is a typed Container projection.

personal_os_get_projectA

Get one owned Project; a foreign or wrong-typed Container is returned as not found.

personal_os_create_projectA

Create a Project under an owned active Area.

personal_os_update_projectA

Partially update an owned active Project. Only supplied fields change.

personal_os_archive_projectA

Archive this Project. It disappears from active views but can be restored.

personal_os_restore_projectA

Restore this archived Project. This is archive restoration, not Trash recovery.

personal_os_delete_projectA

CONFIRMATION REQUIRED. Permanently and irreversibly delete this Project, subject to existing Container guards.

personal_os_list_collectionsA

List active owned Collections. Collection is a typed Container projection.

personal_os_get_collectionA

Get one owned Collection; a foreign or wrong-typed Container is returned as not found.

personal_os_create_collectionC

Create a root-level Collection Container for grouping Tasks; it is not a Checklist.

personal_os_update_collectionA

Partially update an owned active Collection. Only supplied fields change.

personal_os_archive_collectionA

Archive this Collection. It disappears from active views but can be restored.

personal_os_restore_collectionA

Restore this archived Collection. This is archive restoration, not Trash recovery.

personal_os_delete_collectionA

CONFIRMATION REQUIRED. Permanently and irreversibly delete this Collection, subject to existing Container guards.

personal_os_list_notesA

List active owned plain-text Notes.

personal_os_get_noteA

Get one owned plain-text Note.

personal_os_create_noteB

Create a plain-text Note with optional eligible Container, planning, appearance, and complete Tag set.

personal_os_update_noteA

Partially update an active owned Note; tag_ids replaces the complete Tag set.

personal_os_complete_noteC

Mark a Note complete using the existing API lifecycle.

personal_os_uncomplete_noteA

Return a completed Note to its incomplete state.

personal_os_archive_noteA

Archive a Note. It disappears from active views but can be restored.

personal_os_restore_noteA

Restore an archived Note. This is not Trash recovery.

personal_os_delete_noteA

CONFIRMATION REQUIRED. Permanently and irreversibly delete this Note; Notes do not use Trash.

personal_os_list_inbox_itemsB

List the bounded mixed Inbox feed of Tasks, Notes, and Checklists.

personal_os_list_archive_itemsA

List the bounded mixed Archive feed of Tasks, Notes, and Checklists.

personal_os_list_planning_itemsB

List mixed items for an existing unified planning view.

personal_os_list_planning_tasksA

List active Tasks in an authoritative planning view. scheduled requires a date.

personal_os_get_task_planningA

Read one Task's current planning and due fields through the existing Task detail endpoint.

personal_os_list_reviewsA

List owned review session history.

personal_os_list_review_typesA

List available review types and current availability.

personal_os_get_reviewB

Get an owned review session and its snapshot items.

personal_os_start_reviewA

Start or resume one review session of an existing ReviewType.

personal_os_update_review_sectionA

Update the current section marker of an in-progress owned review session.

personal_os_apply_review_actionB

Apply one existing ReviewAction to one snapshot item. Source lifecycle and ownership remain API-controlled.

personal_os_skip_review_itemB

Skip one pending item in an owned review session.

personal_os_complete_reviewB

Complete a review only when no pending items remain.

personal_os_abandon_reviewA

CONFIRMATION REQUIRED. Abandon an in-progress review session; history is retained.

personal_os_get_review_summaryA

Get section and action totals for an owned review session.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/likalg/personal-os-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server