Personal OS MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PERSONAL_OS_AI_TOKEN | Yes | AI token for authentication with Personal OS | |
| PERSONAL_OS_BASE_URL | No | Base URL of the Personal OS instance | http://localhost:8080 |
| PERSONAL_OS_MCP_TIMEOUT_SECONDS | No | Timeout in seconds for MCP operations | 15 |
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
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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