Akiflow MCP Server

MCP server for Akiflow task management with Meeting Assistant support.

Features

• Get tasks, events, calendars with filters

• Create and update tasks

• Schedule/unschedule tasks on calendar

• Mark tasks done

• List projects and tags

• Meeting Assistant: Get recordings with summaries, transcripts, and action items

• Meeting Briefs: Get pre-meeting research briefs

• Action Items → Tasks: Create Akiflow tasks directly from meeting action items

• Auto-refreshing authentication

• Persistent local cache with per-entity sync tokens for faster repeated queries

Setup

1. Get Your Refresh Token

1. Open Akiflow web app (web.akiflow.com)

2. Open DevTools: Cmd+Option+I (Mac) or Ctrl+Shift+I (Windows/Linux)

3. Go to Network tab

4. Refresh the page or wait for a refreshToken request

5. Copy the refresh_token value from the request/response

2. Configure MCP

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "akiflow": {
      "command": "npx",
      "args": ["-y", "@shrimpwtf/mcp-akiflow@latest"],
      "env": {
        "AKIFLOW_REFRESH_TOKEN": "your_refresh_token_here"
      }
    }
  }
}

Sync Model

• v5 entities (tasks, events, tags, labels, time_slots, calendars) are cached locally and refreshed with per-entity sync_tokens

• Meeting Assistant resources (recordings, researches) are cached separately using cursor-based refreshes

• Tool queries run against the merged local cache after refresh, so date filtering and sorting happen on a complete local view rather than partial API deltas

Available Tools

Tasks

get-tasks

List tasks with optional filters.

• done (boolean): Filter by completion status (default: false)

• status (string): 1=Inbox, 2=Planned, 4=Snoozed, 7=Someday, 10=Scheduled

• limit (number): Max tasks to return

add-task

Create a new task.

• title (string, required): Task title

• description (string): Task description

• date (string): Plan date (YYYY-MM-DD)

• datetime (string): Plan datetime (ISO 8601)

• due_date (string): Deadline (YYYY-MM-DD)

• duration (number): Duration in minutes

• priority (string): -1=goal, 1=high, 2=medium, 3=low

• status (string): 1=Inbox, 2=Planned, 7=Someday, 10=Scheduled

• listId (string): Project UUID

• tags_ids (array): Tag UUIDs

edit-task

Update an existing task.

• id (string, required): Task UUID

• All fields from add-task (optional, nullable to clear values)

mark-done

Mark a task as completed.

• id (string, required): Task UUID

schedule-task

Schedule a task on the calendar.

• id (string, required): Task UUID

• date (string, required): Date (YYYY-MM-DD)

• datetime (string): Specific time (ISO 8601)

• duration (number): Duration in minutes (default: 30)

unschedule-task

Remove a task from the calendar.

• id (string, required): Task UUID

• to_inbox (boolean): Move to inbox (default: true)

Calendar

get-events

Get calendar events.

• limit (number): Max events to return

• calendar_id (string): Filter by calendar ID

get-calendars

Get all calendars with metadata.

Meeting Assistant

Requires the Meeting Assistant add-on in Akiflow.

get-recordings

List meeting recordings.

• limit (number): Max recordings to return

get-recording

Get full detail for a single recording including summary, action items, and transcript.

• id (string, required): Recording UUID

get-meeting-briefs

List pre-meeting research briefs.

• limit (number): Max briefs to return

get-meeting-brief

Get full detail for a single pre-meeting brief.

• id (string, required): Meeting brief UUID

create-task-from-action-item

Create an Akiflow task from a meeting recording's action item.

• recording_id (string, required): Recording UUID

• action_item_id (string, required): Action item ID within the recording

Organization

get-projects

List all projects and folders.

get-tags

List all tags.

API Details

Task Status

• 1: Inbox

• 2: Planned

• 4: Snoozed

• 7: Someday

• 10: Scheduled

Task Priority

• -1: Goal

• 1: High

• 2: Medium

• 3: Low

• null: None

Date Formats

• Date: YYYY-MM-DD

• Datetime: ISO 8601 (2026-01-26T10:00:00.000Z)

Security

• Refresh token is sensitive - treat like a password

• Never commit tokens to git

• Access tokens auto-refresh on 401

License

MIT