Skip to main content
Aki & AI Features

Akiflow MCP

Akiflow's MCP (Model Context Protocol) server lets you connect AI assistants like Claude, ChatGPT, Cursor, and Windsurf directly to your Akiflow account. Once connected, your AI assistant can help manage tasks and subtasks, read and filter your schedule, create and edit calendar events, work with time slots, and use Meeting Assistant transcripts.

MCP server URL

https://mcp.akiflow.com/mcp

Use this full URL when your AI tool asks for a remote MCP server URL. Your AI tool will prompt you to sign in with your Akiflow account when you connect.

You can also find this URL inside the Akiflow desktop app under Settings → MCP.

What you can do with Akiflow MCP

Once connected, you can ask your AI assistant to:

  • View and filter your schedule - “What does my day look like tomorrow?”, “Show my overdue tasks,” “Which tasks did I complete this week?”, “Show meetings with guests next week,” or “Sort tomorrow’s work by priority or duration.”

  • Create tasks - "Create a task to review the Q3 report, due Friday"

  • Create and manage subtasks - “Create a task called ‘Launch website’ with the subtasks ‘Write copy’, ‘Review pricing’, and ‘Publish page’,” “Show me the subtasks under Launch website,” “Move Review pricing under Launch website,” or “Mark Write copy as done.”

  • Plan tasks for a day, week, or month – "Plan this for next week," "Move this to June," or "Schedule this tomorrow at 9."

  • Check your inbox or someday list – "What tasks are in my inbox right now?" or "Show my someday tasks."

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

  • Update tasks – "Set this to high priority," "Add it to my Roadmap project," "Add a 45 minute duration," or "Mark the report task as done."

  • Move tasks back to the inbox – "Move this task back to my inbox."

  • Create calendar events - "Block 2 hours tomorrow morning for deep work"

  • Browse projects, tags, calendars, and priorities – "Show me my high-priority tasks" or "What is in my Roadmap project?"

  • Use Meeting Assistant transcripts – "Summarize my last meeting," "What were the action items from my 10am call?", or "Find the transcript for this calendar event."

  • Edit or cancel calendar events – "Move my 3pm meeting to tomorrow," "Add Alex as a guest," or "Cancel this event."

  • Use connected calendar details – "Which calendar is my primary calendar?", "Create that event on my work calendar," or "Who is invited to this meeting?"

  • Read specific items by ID – "Open this task again," "Show details for this event," or "Check this time slot" after your assistant has found or created an item.

Akiflow MCP gives your AI assistant visibility into all your connected calendars through a single connection.

Task locations and project sections

Ask your assistant to add, change, remove, or read a task’s location. A location can be a street address, place name, or meeting link. For example: “Add Via Roma 1, Milano to my dentist task” or “Remove the location from this task.”

You can also assign tasks to existing project sections, move them between sections, or clear their section. For example: “Move this task to Marketing, Ideas section” or “Create a task in Product, Backlog section.” Sections belong to a project; create or rename sections in Akiflow.

Responding to calendar invitations

Ask your assistant to accept, decline, or mark an invitation as Maybe on Google Calendar or Outlook. For example: “Accept tomorrow’s team meeting” or “Decline my invitations next week while I’m away.” Your assistant can check your current response and whether an event allows RSVP. Changes may appear as pending while your calendar provider processes them.

For recurring invitations, specify whether you mean one occurrence or the whole series. Occurrences you already answered individually keep their own response when you respond to the series, so ask your assistant to check for exceptions.

RSVP is unavailable for view-only calendars and unsupported providers, including iCloud. You cannot RSVP to an Outlook meeting you organize. Canceling that meeting is a separate action that affects everyone; declining an invitation should not be treated as a request to cancel it.

Setup guides

Pick your AI tool and follow the steps below.

Free Claude accounts may be limited to one custom connector.

This is the recommended way to connect if you have a paid Claude plan.

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

  2. Go to Customize > Connectors.

  3. Click Add custom connector (or Add, depending on your plan).

  4. Enter the following:

    • Name: Akiflow

    • Remote MCP Server URL: https://mcp.akiflow.com/mcp

  5. Click Add.

  6. Find "Akiflow" in your connectors list and click Connect.

  7. Sign in with your Akiflow account when prompted.

You are all set. In any chat, click the + button, select Connectors, and make sure Akiflow is enabled.

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 authentication flow.

Adding a custom MCP server in ChatGPT requires Developer Mode, which is in beta. Availability depends on your ChatGPT plan and workspace settings. On team workspaces, an admin or owner may need to enable Developer Mode before members can create or use custom MCP connectors. If you do not see the option, check OpenAI's current documentation for Developer Mode and MCP apps.

  1. Open ChatGPT on the web.

  2. Go to Settings > Apps & Connectors (labelled Connectors on some accounts).

  3. Open Advanced settings and toggle Developer mode on, then confirm the warning. (Developer Mode can disable memory in those chats.)

  4. Back on the Apps & Connectors page, click Add custom connector (or Add).

  5. Enter the following:

    • Name: Akiflow

    • MCP Server URL: https://mcp.akiflow.com/mcp

    • Authentication: OAuth

  6. Click Add / Create.

  7. Sign in with your Akiflow account when prompted.

  8. In a chat, open the tools menu and make sure the Akiflow connector is enabled.

  1. In the Cursor chat composer, click the "+" button and choose MCP Servers → Add MCP.

  2. In the Browse MCPs window, click Custom MCP (Add your own MCP server).

  3. Fill in the form:

  4. Click Add MCP.

  5. Cursor will try to connect and open a browser window to sign in with your Akiflow account. Approve it to authorize the connection.

  6. Once connected, "Akiflow" appears with a green status and its available tools. Start a chat in Agent mode and ask Akiflow to do something, e.g. "What's on my schedule tomorrow?".

  1. Press Ctrl + , (Windows) or Cmd + , (Mac) to open Windsurf settings, then open Advanced Settings.

  2. Scroll to the Cascade section and find MCP servers.

  3. Click Add Server, then Add custom server +.

  4. Add the following to your config file:

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

  1. Complete the authentication flow when prompted.

Any tool that supports the Model Context Protocol can connect to Akiflow. If your tool supports remote MCP servers, point it to:

https://mcp.akiflow.com/mcp


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

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


Check your tool's documentation for where to place MCP server configurations.

Tips for getting the most out of Akiflow MCP

  • Use clear task titles. Your AI assistant relies on task titles to understand what each task is about. Descriptive titles lead to better results.

  • 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, tag, or calendar. Your assistant can look up your projects, tags, and calendars before creating or editing items.

  • Tell it when not to notify guests. For calendar events with guests, invitations and updates are sent by default. Say "do not notify guests" to request a silent change. Outlook meeting cancellations still notify attendees, even when you request no notifications.

  • Use item IDs for precise follow-up. When the assistant creates or finds a task, event, or time slot, it can use that ID later to read or update the same item.

  • Ask for the details you need. Schedule results can include deadlines, durations, project names, tag names, event descriptions, locations, recurrence, calendar names, guest counts, and guest response status.

  • Set task durations. If your tasks have durations set, your AI assistant can schedule them more intelligently into available calendar slots.

  • Ask for a specific date range. Scheduled tasks and events are read over a date range. If something is missing, ask the assistant to check a specific period, such as "last month" or "next quarter."

FAQ

Akiflow MCP is available on all paid plans.

Akiflow MCP uses OAuth 2.1 for authentication. Your AI tool signs in as you and can only access Akiflow data that your account can access. The AI tool can receive data it requests through MCP while you use the connector. You can remove the connector from your AI tool or revoke access from Akiflow at any time.

Yes. Remove or disable the Akiflow connector from your AI tool's settings. You can also revoke access from within your Akiflow account.

Yes. When you ask it to add guests, it can invite up to 200 people, and by default Akiflow emails them an invitation, just like creating an event in the app. If you want the event on your calendar without notifying anyone, tell your assistant not to send invites. You can also request silent edits. Outlook meeting cancellations still notify attendees, even when you request no notifications.

Tasks are moved to Trash rather than deleted permanently. You can find trashed tasks in the Desktop or Web app under All tasks > Trashed and restore them. A restored task goes back to your Inbox.

Calendar events are canceled, which removes them from your calendar. Whether they can be recovered depends on your calendar provider's own trash or undo behavior, not Akiflow.

Your inbox and someday tasks are always available through task list tools. Scheduled tasks, calendar events, and time slots are read over a date range, up to about 90 days per request. If something falls outside the range the assistant checked, ask it to search a specific period, for example "look at last month" or "check next quarter."

If the assistant already has the item ID, ask it to open that specific task, event, or time slot.

Yes, as long as your tool supports the MCP standard. Use the server URL https://mcp.akiflow.com/mcp and follow your tool's documentation for adding a custom MCP server.

Yes. When you create an event with guests, Akiflow can attach your configured conference solution, such as Google Meet, Zoom, or Microsoft Teams, when one is set for that calendar account.

Akiflow MCP can work with a single occurrence of a recurring task, time slot, or event when that occurrence is returned by Akiflow. For invitation responses, you can also ask it to RSVP to the whole event series. Occurrences already answered individually keep their own response. Specify the scope clearly, especially when responding to or canceling recurring calendar events.

Planning is when you intend to do the task. A task can be planned for a date, a specific time, a whole week, or a whole month.

A deadline is when the task is due. A task can have a deadline even if it is still in your Inbox or Someday list. In MCP, overdue task views are based on missed planned dates or times, not on deadlines alone.

Yes. Akiflow MCP can place tasks, time slots, and events in the past when you explicitly ask it to. This is useful for backfilling, correcting records, or organizing work that already happened.

Yes, if Meeting Assistant recorded the meeting. The assistant can list recent recordings, fetch a full transcript by transcript ID, or fetch the transcript associated with a calendar event. Transcript access is read-only.

Akiflow MCP rejects unknown or contradictory fields instead of guessing. Rephrase the request in plain language and make the intended placement clear. For example, say "put this in my inbox" or "plan this for tomorrow at 9," but not both in the same instruction.

Not yet. Akiflow MCP does not currently support filtering tasks by project as a built-in query.

Your AI assistant can list your projects, and task results include the project each task belongs to. This means some AI tools may be able to fetch tasks and filter them locally, but this depends on the AI client rather than Akiflow MCP itself.

Native project-based task filtering may be added in a future update.

Yes. Akiflow MCP treats subtasks as regular Akiflow tasks connected to a parent task. Your AI assistant can create, read, edit, plan, reschedule, complete, delete, move, and detach subtasks. For example, when you ask it to create a parent task with several subtasks, it first creates the parent and then creates each subtask under it. These are real Akiflow subtasks, not a checklist added to the task description. Subtasks remain independent: completing a parent does not complete its subtasks. Trashing a parent detaches its direct subtasks instead of deleting them. Recurring tasks cannot currently be parents or subtasks, and reordering subtasks is not supported through MCP.

Akiflow MCP is not limited to the email you use to sign in. It can access calendars that are visible in Akiflow on desktop or mobile.

A calendar may be connected but hidden. Akiflow generally does not sync events from hidden calendars, so MCP cannot read or create events on them. Open your calendar list in Akiflow, make sure the affected calendar is visible, and try again.

Still need help? Ask the team