How to Use the Structured MCP Server

Connect Structured to AI assistants via the Model Context Protocol (MCP). This lets tools like ChatGPT, Claude, Cursor, Google Antigravity, Google Gemini CLI, or OpenCode read, manage, and edit your tasks in Structured.

Please note that some features require ⭐️ Structured Pro.

This article contains information about:

(1) Available Features with Structured MCP

(2) How to Set Up the Structured MCP Server

(2.1) Create Structured Cloud Account

(2.2) Set Up ChatGPT

(2.3) Set Up Claude Desktop

(2.4) Set Up Claude Code

(2.5) Set Up Cursor

(2.6) Set Up Google Antigravity

(2.7) Set Up Google Gemini CLI

(2.8) Set Up OpenCode

(3) Example Prompts

The Structured MCP server lets you connect AI assistants such as ChatGPT or Claude read, manage, and edit your tasks in Structured.

In easier words, when connecting your preferred AI tool with Structured, you can write prompts (instructions) in the AI chat to receive information about your tasks in Structured or make edits that are then synced back to your actual schedule in Structured.

In total, the Structured MCP server allows your AI to:

• View your schedule — see today's tasks, upcoming days, or your inbox.

• Create tasks — with title, time, duration, color, icon, and alerts.

• Update tasks — reschedule, rename, change properties.

• Complete tasks — mark tasks as done.

• Delete tasks — remove tasks you no longer need.

• Recurring tasks (requires ⭐️ Structured Pro) — create and manage repeating tasks

You will find example prompts in section (3) below.

In order to use the Structured MCP server, you need a Structured Cloud account. If you're already using Structured Cloud sync, you can skip this step.

If you don't use Structured Cloud sync yet, learn how to set it up here.

In order to add Structured to ChatGPT:

1. Access https://chatgpt.com/

2. Select Apps and search for Structured or click this link.

3. Choose Connect.

4. Click Sign in with Structured.

5. This will take you to your Structured Cloud log-in. Enter your Structured Cloud email & select Continue. Enter the 6-digit code you received via email & select Continue.

6. Authorize ChatGPT's access to read and manage your tasks. Now, you're all set up.

To communicate with Structured in ChatGPT, simply use @Structured to read and manage your Structured schedule.

In order to add Structured to Claude Desktop:

1. Open Settings.

2. Head over to Connectos and select Add custom connector.

3. Fill in:

   Field	Value
   Name	Structured
   Remote MCP server URL	https://mcp.structured.app/mcp
   OAuth Client ID	acd1a0cb-ada5-44ef-90bb-104c2aae541a

4. Click Add and then Connect.

5. This will take you to your Structured Cloud log-in. Enter your Structured Cloud email & select Continue. Enter the 6-digit code you received via email & select Continue.

6. Authorize Claude's access to read and manage your tasks. Now, you're all set up.

If you already set up Structured in Claude Desktop (see section (2.3)), it is automatically available in Claude Code as claude.ai Structured, so there's extra setup needed.

If you don't use Claude Desktop:

1. Run this command in your terminal:

   claude mcp add --transport http \ --client-id 48550a62-e040-47d8-ba02-364446e978c4 \ --callback-port 9876 \ structured \ https://mcp.structured.app/mcp

2. Next, launch Claude Code, type /mcp and choose Structured → Authenticate.

3. This will take you to your Structured Cloud log-in. Enter your Structured Cloud email & select Continue. Enter the 6-digit code you received via email & select Continue.

4. Authorize Claude's access to read and manage your tasks.

5. After that, the session refreshes automatically. Now, you're all set up.

In order to add Structured to Cursor:

1. Open Settings.

2. Head over to Tools & MCPs and select New MCP Server.

3. Paste the following into the mcp.json file that opens:

   { "mcpServers": { "Structured": { "type": "http", "url": "https://mcp.structured.app/mcp", "auth": { "CLIENT_ID": "bf2273b6-1ef2-44e0-80d3-2839b417f846" } } } }

4. Save and close the tab.

5. Click Connect. This will take you to your Structured Cloud log-in. Enter your Structured Cloud email & select Continue. Enter the 6-digit code you received via email & select Continue.

6. Allow Cursor's access to read and manage your tasks.

7. Now, you're all set up.

In order to add Structured to Google Antigravity:

1. Open the MCP Servers via the "…" dropdown at the top of the editor's agent panel.

2. Click Manage MCP Servers and select View raw config.

3. Add the Structured server to your mcp_config.json:

   { "mcpServers": { "Structured": { "serverUrl": "https://mcp.structured.app/mcp", "oauth": { "clientId": "1861fc5c-e612-44d8-83d5-b77819f87e71" } } } }

4. Save the file and return to Antigravity.

5. You will be prompted to log in to your Structured Cloud account. Enter your Structured Cloud email & select Continue. Enter the 6-digit code you received via email & select Continue.

6. Now, you're all set up.

In order to add Structured to Google Gemini CLI:

1. Open (or create) the file ~/.gemini/settings.json.

2. Add the Structured MCP server configuration:

   { "mcpServers": { "Structured": { "url": "https://mcp.structured.app/mcp", "type": "http", "oauth": { "enabled": true, "clientId": "6fe03d01-2695-4207-9588-678b1860c644", "redirectUri": "http://localhost:55805/oauth/callback" } } } }

3. Save the file and launch Gemini CLI.

4. Type /mcp auth and select Structured from the list to initiate the authentication flow.

5. This will take you to your Structured Cloud log-in. Enter your Structured Cloud email & select Continue. Enter the 6-digit code you received via email & select Continue.
   
   ⚠️ Important: When the browser opens for sign-in, the authorization URL in the address bar may contain multiple scope values (e.g. scope=email,profile,...). Before pressing Login, you must edit the URL so that only scope=email remains. Remove any other scope entries. If extra scopes are present, authentication will fail. The same URL is also printed in your Gemini CLI terminal, so you can copy it from there, fix the scopes, and open it manually.

6. Now, you're all set up.

In order to add Structured to OpenCode:

1. Install the OpenCode CLI (for example: brew install opencode).

2. Add the Structured MCP config to ~/.config/opencode/opencode.jsonc:

   { "$schema": "https://opencode.ai/config.json", "mcp": { "structured": { "type": "remote", "url": "https://mcp.structured.app/mcp", "enabled": true, "oauth": { "clientId": "89b2893e-d218-4476-907b-e382fc145666" } } } }

3. Then run opencode mcp auth structured to initiate the authentication flow.

4. This will take you to your Structured Cloud log-in. Enter your Structured Cloud email & select Continue. Enter the 6-digit code you received via email & select Continue.

5. After authentication, restart any desktop clients so they pick up the new session.

6. Now, you're all set up.

Following, we provide some example prompts to give you an idea of what you can do with the Structured MCP.

@Structured what is on my timeline today?

@Structured what is in my inbox?

@Structured create an all-day grocery shopping tasks for making lasagna with all ingredients as subtasks.

@Structured create a blue colored task for the afternoon to tidy up using a vacuum icon.

@Structured create a weekly recurring task for Thursdays at 5pm that lasts an hour for my weekly run.
(⚠️ recurring tasks require ⭐️ Structured Pro)

@Structured move all of today's tasks by one hour.

@Structured change the color of all events called "Meeting" to orange.

@Structured mark all of today's tasks as done.

@Structured delete all of today's completed tasks.