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.