Akiflow MCP connects AI assistants like Claude, ChatGPT, Cursor, and Devin Desktop (formerly Windsurf) to your Akiflow account. Once connected, your assistant can manage tasks and subtasks, read your schedule, create and edit calendar events and time slots, find time with other people, work with files attached to tasks, and use your Meeting Assistant transcripts.

MCP stands for Model Context Protocol, the open standard AI tools use to connect to other apps.

Before you start

• Plan: Akiflow MCP is available on all paid plans and during your free trial.

• Where you connect: you set up the connection inside your AI tool, not inside Akiflow. Your AI tool asks you to sign in with your Akiflow account.

• Server URL: some AI tools ask for a remote MCP server URL. Use the full URL below.

https://mcp.akiflow.com/mcp

You can also copy this URL in the Akiflow desktop app: click your avatar at the bottom of the menu, then Settings > Akiflow MCP.

Connect your AI tool

Pick your AI tool and follow the steps.

Claude

Akiflow is listed in Claude’s connector directory, so you do not need the server URL.

1. Open Claude in your browser or the desktop app.

2. Go to Customize > Connectors and open Discover.

3. Search for Akiflow, open it, and click Connect.

4. Sign in with your Akiflow account when prompted.

In any chat, check that Akiflow is enabled in the connectors menu.

On Claude Team and Enterprise plans, an owner has to enable Akiflow for the organization before members can connect.

Can’t find Akiflow in the directory? Add it as a custom connector instead: go to Customize > Connectors, click Add, hover Custom, and choose Web. Name it Akiflow, paste https://mcp.akiflow.com/mcp as the remote MCP server URL, and click Add. Free Claude accounts can add one custom connector.

Claude Code

Run this command in your terminal:

claude mcp add --transport http akiflow https://mcp.akiflow.com/mcp

Then run /mcp inside a Claude Code session to complete the sign-in.

ChatGPT

ChatGPT connects to Akiflow as a custom app in Developer Mode, which is in beta on ChatGPT on the web. Full access, including creating and editing items, is available on ChatGPT Business, Enterprise, and Edu. On ChatGPT Pro, Developer Mode can only read your Akiflow data. On Business, an admin or owner has to turn on Developer Mode for the workspace first. On Enterprise and Edu, an admin grants it to members.

1. Open ChatGPT on the web.

2. Go to Settings > Apps > Advanced settings and turn on Developer mode.

3. In Settings > Apps, click Create.

4. Enter the name Akiflow and the MCP server URL https://mcp.akiflow.com/mcp, and choose OAuth as authentication.

5. Click Scan Tools and sign in with your Akiflow account when prompted.

6. Click Create.

7. In a new chat, select Akiflow from the tools menu.

Cursor

1. Open your Cursor MCP config file: ~/.cursor/mcp.json to use Akiflow in every project, or .cursor/mcp.json inside one project.

2. Add this and save:

{ "mcpServers": { "akiflow": { "url": "https://mcp.akiflow.com/mcp" } } }

3. Sign in with your Akiflow account when Cursor asks.

4. Start a chat in Agent mode and try “What’s on my schedule tomorrow?”

If the sign-in fails, check the MCP logs in Cursor’s Output panel.

Devin Desktop (formerly Windsurf)

1. In the Cascade panel, click the … menu in the top right.

2. In the MCPs section, click Open MCP config file.

3. Add this and save:

{ "mcpServers": { "akiflow": { "serverUrl": "https://mcp.akiflow.com/mcp" } } }

4. Sign in with your Akiflow account when prompted.

Other AI tools

AI tools that support remote MCP servers with OAuth sign-in can connect to Akiflow. Point your tool to https://mcp.akiflow.com/mcp and follow its documentation for adding a custom MCP server.

If your tool only supports local (stdio) MCP servers, use the mcp-remote package as a bridge:

{ "mcpServers": { "akiflow": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.akiflow.com/mcp"] } } }

What you can do with Akiflow MCP

Once connected, ask your AI assistant in plain language. The examples below are things you can say.

Tasks

• Create tasks in your Inbox, in Someday, or planned for a day, a time, a whole week, or a whole month. “Create a task to review the Q3 report, due Friday.”

• Read your lists. “What is in my inbox right now?”, “Show my someday tasks”, “Show my overdue tasks”, “Show my high-priority tasks.”

• Update tasks: priority, duration, deadline, description, links, project, section, and tags. “Set this to high priority”, “Add a 45 minute duration.”

• Plan and reschedule. “Plan this for next week”, “Move this to June”, “Schedule this tomorrow at 9”, “Move this back to my inbox.”

• Complete tasks, and review what you finished. “Mark the report task as done”, “Which tasks did I complete this week, and when?”

• Create and manage subtasks. “Create a task called Launch website with the subtasks Write copy, Review pricing, and Publish page”, “Move Review pricing under Launch website.”

• Create recurring tasks. “Create a task to send the weekly report every Friday at 4.”

• Organize with projects, sections, and tags. Your assistant can assign tasks to them, and create or rename sections and tags. “Create an Ideas section in Marketing and move this task there”, “Create a tag called Waiting.”

• Add a location: a street address, place name, or meeting link. “Add Via Roma 1, Milano to my dentist task.”

Files on tasks

• See and read attached files. Your assistant can read images (JPEG, PNG, GIF, WebP) and text files such as plain text, CSV, JSON, and Markdown. For other files, such as PDFs, Word documents, and spreadsheets, it gets a download link but cannot read the content.

• Attach a file to a task. This works in AI tools that can open files on your computer and upload them, such as Claude Code or Cursor. A task holds up to 10 files of 25 MB each, within your storage limit.

• Delete a file. Deleting a file is permanent. It does not go to Trash.

A file attached to a recurring task is attached to the whole series.

Calendar events

• Read your schedule across the calendars visible in Akiflow. “What does my day look like tomorrow?”, “Show meetings with guests next week”, “Who is invited to this meeting?”

• Create events: timed, all-day, or recurring, on the calendar you name. “Block 2 hours tomorrow morning for deep work”, “Create that event on my work calendar.”

• Edit or cancel events. “Move my 3pm meeting to tomorrow”, “Add Alex as a guest”, “Add a meeting link”, “Cancel this event.”

• Find time with other people. “Find 30 minutes with alice@company.com tomorrow afternoon.” Give your assistant the email addresses, up to 10 people per request.

• Respond to invitations on Google Calendar or Outlook: accept, decline, or Maybe. “Accept tomorrow’s team meeting”, “Decline my invitations next week while I’m away.”

About finding time: what your assistant sees depends on what your connected Google or Outlook accounts can see. For calendars shared with you, it sees event details. Otherwise it sees only busy and free blocks, and it tells you when someone’s availability is not visible at all.

About invitations: for recurring invitations, say whether you mean one occurrence or the whole series. Occurrences you already answered keep their own response. RSVP is unavailable for view-only calendars and for iCloud, and you cannot RSVP to an Outlook meeting you organize. Declining is never treated as canceling: canceling a meeting you organize is a separate request that affects everyone.

Time slots

• Create and edit time slots. “Create a 90 minute time slot tomorrow at 9 for the report.”

• Put tasks inside a time slot, or link a time slot to a project.

• Choose which calendar a time slot is locked to. “Lock it to my work calendar.” This works for single time slots, not recurring ones.

Moving a time slot moves the tasks inside it.

Meeting transcripts

If Meeting Assistant recorded the meeting, your assistant can list recent recordings and read the full transcript. “Summarize my last meeting”, “What were the action items from my 10am call?”, “Find the transcript for this calendar event.” Transcript access is read-only.

Not supported yet

These actions are not available through Akiflow MCP today. Do them in Akiflow instead.

• Showing all tasks in a project. Your assistant can list your projects, and each task it reads shows its project, but it cannot ask Akiflow for one project’s tasks. Some AI tools work around this by reading your tasks and filtering them on their side.

• Creating, renaming, or deleting projects and folders.

• Deleting or merging tags, deleting, reordering, or moving sections, and changing colors or icons.

• Deleting time slots, unlocking a time slot from its calendar, and creating recurring time slots.

• Editing a whole recurring series. Your assistant edits one occurrence of a recurring task, event, or time slot at a time, and cannot add or change the repeat rule of an existing task. It can cancel a whole recurring event series.

• Recurring tasks as parents or subtasks, and reordering subtasks.

• Reading the content of PDFs, Word documents, and spreadsheets attached to tasks.

• Travel Time on events.

• RSVP on iCloud and view-only calendars.

Tips for getting the most out of Akiflow MCP

• Use clear task titles. Your assistant relies on titles to understand what each task is about.

• Be specific about timing. Say whether you want a task planned for an exact time, a whole day, a whole week, or a whole month.

• Name the project, section, tag, or calendar. Your assistant looks them up before creating or editing items.

• Ask for a specific date range. Scheduled tasks, events, and time slots are read over a date range of up to about 90 days per request. If something is missing, ask for a period such as “last month” or “next quarter.”

• Set task durations. With durations set, your assistant can fit tasks into open calendar time more accurately.

• Tell it when not to notify guests. Invitations and updates are sent by default. Say “do not notify guests” for a silent change. Outlook meeting cancellations always notify attendees.

• Point at an exact task. Right-click a task in Akiflow and choose Copy Task ID, then paste it into your AI tool.

• Start from Akiflow. The Work with AI menu on any task, event, or time slot opens it in Claude or ChatGPT with its context.

• Open results in Akiflow. When your assistant creates or finds an item, it returns a link that opens that item in Akiflow.

• Confirm before deleting files. Deleted files cannot be restored, so ask your assistant to name the file before it deletes one.

FAQ

Access and privacy

Calendar

Tasks

Troubleshooting