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