# Structured MCP

> Structured MCP Server lets your AI client manage your daily planner, tasks, and routines directly from your terminal. Your agent can read all scheduled events, create new tasks, update deadlines, or even retrieve your user profile—all without you opening the mobile app. It treats your personal agenda like a database, letting you programmatically control your day.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** daily-planner, task-management, time-blocking, routine-automation, schedule-optimization

## Description

This Structured MCP Server lets your AI client treat your personal planner like a database you can programmatically control. You don't gotta open that goddamn mobile app just to check something off or change a date. Your agent acts as a dedicated scheduling assistant, giving you full command over your routines and daily tasks.

**Viewing Your Schedule**

Your AI client pulls everything scheduled into a clear overview using `list_tasks`, which retrieves every active item in your planner. You can drill down on any single commitment by running `get_task_details`, pulling all the specific metadata, notes, and required context associated with it. When you need to understand your established routines or multi-step life plans, run `list_plans` to see a full inventory of stored templates. To grasp how a routine works before executing it, use `get_plan_details`; this action pulls the entire structural breakdown and any hard constraints governing that plan.

**Creating New Entries**

You can add single, one-time obligations using `create_task`, specifying an optional start date or time for when it's due. If you need to set up a whole new multi-step routine—a full life plan—you use the `create_plan` tool. These tools let you build structure right into your day.

**Managing and Modifying Tasks**

The system lets you change existing items whenever they shift. You modify an item's deadline or mark it as finished using `update_task`. If a task is canceled entirely, running `delete_task` permanently removes that specific commitment; be warned, this action can't be undone.

**Checking Your Settings and Identity**

To verify your linked account details—like whether you're on Pro or what your operational timezone is—you run `get_user_profile`. This gives you an immediate status check without needing to log into anything else. It’s a straight shot at managing every piece of data in your personal agenda.

## Tools

### create_plan
Adds an entirely new multi-step routine or life plan into Structured.

### create_task
Adds a single, one-time task with an optional start date and time.

### delete_task
Permanently removes a specified task. This action cannot be undone.

### get_plan_details
Retrieves the full structural details and constraints of an existing plan or routine.

### get_task_details
Pulls all specific metadata for a single task, including notes and required context.

### get_user_profile
Retrieves your user-level information, such as account status or operational timezone.

### list_plans
Lists all the custom routines and plans you have created in Structured.

### list_tasks
Retrieves a full list of every task currently scheduled in your planner.

### update_task
Modifies an existing task, letting you change its deadline or mark it as finished.

## Prompt Examples

**Prompt:** 
```
Assess my active Structured environment, listing today's pending tasks, and mark the scheduled meeting block as successfully completed.
```

**Response:** 
```
Validating parameters seamlessly...
**Current Pending Tasks Mapped (`list_tasks`)**:
- `Code Architecture Assessment`
- `Managerial Meeting`

Updating attribute structurally calling task parameter natively:
- Task `Managerial Meeting` has been updated cleanly. `isCompleted` now reflects successfully finalized metric natively explicitly effectively correctly.
Ready to process subsequent routine deployments actively.
```

**Prompt:** 
```
List all active plans for the week, and display the detailed constraints of the 'Morning Focus' routine.
```

**Response:** 
```
Retrieving your routine logic matrices seamlessly...
**Routines Acquired (`list_plans`)**:
- `Morning Focus`
- `Evening Winding Down`

Deep inspecting context using `get_plan_details` natively...
The 'Morning Focus' demands 90 uninterrupted minutes without communication applications.
```

**Prompt:** 
```
Read my user profile cleanly to extract my workspace validation level and operational timezone.
```

**Response:** 
```
Auditing operational attributes accurately...
Executing `get_user_profile` locally natively successfully.
**Authentication Response**:
- User Authorization: `Structured Pro` active successfully.
- Locale Definition: `Europe/London` applied proactively.
The context is perfectly mapped.
```

## Capabilities

### List all scheduled tasks
The agent retrieves every active task in your planner, giving you an overview of what's on the calendar.

### Get specific task details
You pull deep information on a single task, like its associated notes or required resources.

### Create new tasks and plans
The agent adds entirely new items to your planner, whether it's a one-off meeting or a complex multi-day routine.

### Update task status or dates
You modify an existing item—changing its due date, marking it complete, or adjusting the time block.

### List and inspect routines (plans)
The agent reads your stored routine templates, allowing you to understand their structural rules before running them.

### Verify user settings
You check your linked account details, like your operational timezone or Pro subscription status.

## Use Cases

### The executive needs to adjust next week's schedule.
The founder realizes the 'Q3 Strategy Review' task is too early. They simply ask their agent, 'Move the Q3 meeting until Tuesday.' The agent runs `get_task_details` to find the ID and then uses `update_task`, shifting the date and notifying stakeholders—all in one chat interaction.

### The engineer needs to audit all pending tasks for a project.
The software engineer runs, 'Show me every task related to Project Hydra.' The agent executes `list_tasks`, filtering the results by keywords, and then uses `get_task_details` on the top three items to pull required documentation links.

### The creator wants to set up a new writing routine.
Instead of manually setting reminders, the creator tells their agent, 'Set up a 4-week drafting plan.' The agent responds by using `create_plan`, establishing the recurring structure and milestones in Structured for them.

### The team needs to clean up old, unnecessary tasks.
A user identifies several completed or obsolete entries. They prompt their agent: 'Delete all tasks marked as retired.' The agent runs `list_tasks` to find the IDs and uses `delete_task` on each one, keeping the planner clean.

## Benefits

- Need to see what's coming up? Use `list_tasks` to instantly pull a list of all pending items. You get an immediate, comprehensive view without opening the app.
- Missed a meeting and need to reschedule it? Call `update_task` to change the due date or mark the task as complete. It handles the state change directly in Structured.
- Building a new habit? Use `create_plan` to build an entire multi-step routine, like 'Morning Workout,' that your agent can then execute and track over time.
- Don't know what constraints govern your routines? Run `get_plan_details` on any plan. You get the exact structural rules defined for that habit or project flow.
- Want to verify permissions before making changes? Use `get_user_profile`. It returns your current status and timezone, letting you confirm context before running a destructive command like `delete_task`.

## How It Works

The bottom line is that your AI client sends a request, and this server executes the necessary actions against your actual Structured account data.

1. Enable the Structured MCP module and configure it as an active integration within Vinkius.
2. In the parameter matrix, bind your official `STRUCTURED_TOKEN` (found in your Structured Pro settings).
3. Tell your agent what you need: 'List tomorrow's tasks and reschedule the architecture review for 3 PM.'

## Frequently Asked Questions

**How do I list all my tasks using the Structured MCP Server?**
You run `list_tasks`. This command immediately pulls a complete list of every single task currently registered in your planner, letting you see what's pending.

**Can I change a task deadline with update_task?**
Yes. You call `update_task` and provide the specific task ID along with the new date or time. This modifies the original record directly, which is safer than manual edits.

**What does get_user_profile do for my day planner?**
It retrieves your account's core metadata. You use `get_user_profile` to confirm things like if you're on the Pro plan or what your primary operational timezone is before making any changes.

**How do I see all my available routines?**
You call `list_plans`. This function returns a list of every multi-step routine (or 'plan') you've set up, giving you an overview of your habits and long-term goals.

**How does the `delete_task` function handle permanent deletion of a task?**
It performs an irreversible action. This tool permanently removes the task from your Structured account immediately upon execution. Use this command only when you are absolutely sure the item should not be recovered, as there is no undo feature.

**What specific details can I retrieve using `get_task_details`?**
It pulls deep metadata about a single task. You get more than just the title and date; you also access context like associated plans, recurrence rules, and completion status history for that exact task.

**What inputs are required when I use the `create_plan` tool?**
You must provide a unique plan name and description. These fields define the boundaries of your new routine. The system then builds the structural framework for all related tasks under that single, named plan.

**What happens when I use `get_plan_details` for a non-existent routine?**
The server returns an explicit error code and message. It will tell you exactly which Plan ID was missing or if the provided parameters don't match any current plans in your account.

**Do I need a paid plan to use the Structured programmatic API?**
Yes. Programmatic integrations and the ability to systematically generate and query your personal API access require a Structured Pro plan to safely extract the required access tokens securely.

**Can the integration delete past records destructively by accident executing commands natively?**
Risk is inherently mitigated. The AI only calls mutations like `delete_task` precisely when instructed unequivocally. Records aren't inherently purged on exploration, allowing safe queries comprehensively continuously naturally.

**Which platforms does the Structured integration support?**
The MCP connects to the Structured Pro API, which syncs across iOS, iPadOS, macOS, and the web app. Any task created or updated via the AI is reflected on all your devices in real time.