SA

shrimpwtf/akiflow-mcp

API 开发

本页由 AI 翻译,技术细节请以原文为准。 查看原文

28 stars 7 forks 质量 59 趋势 15

Akiflow 任务和日历管理的 MCP 服务器——调度任务、编辑事件、管理项目和标签

概览

Akiflow任务管理的MCP服务器,支持会议助理。 - 获取任务、事件、带筛选功能的日历 - 创建和更新任务 - 在日历上安排/取消任务 - 标记任务已完成 - 列出项目和标签 - : 获取包含摘要、文字记录和行动项的录音 - : 获取会议前的研究简报 - : 直接从会议行动项创建Akiflow任务 - 自动刷新认证 - 持久的本地缓存,带有每个实体同步令牌,以加快重复查询速度 1. 打开 Akiflow 网页应用(web.akiflow.com) 2.打开开发工具:Cmd+Option+I(Mac)或 Ctrl+Shift+I(Windows/Linux) 3.进入标签页 4。刷新页面或等待 refreshToken 请求 5.从请求/响应中复制refresh_token值 添加到你的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config。

概述(AI 翻译)

Akiflow任务管理的MCP服务器,支持会议助理。

特色

  • 获取带有筛选功能的任务、事件、日历
  • 创建和更新任务
  • 日历上的任务安排/取消安排
  • 标记已完成的任务
  • 列表项目和标签
  • 会议助理:获取带有摘要、文字记录和行动事项的录音
  • 会议简报:获取会前研究简报
  • 行动项→任务:直接从会议行动项创建Akiflow任务
  • 自动刷新认证
  • 持久本地缓存,配备每个实体同步令牌,实现更快的重复查询

布置

1.获取你的刷新令牌

  1. 打开Akiflow网页应用(web.akiflow.com)
  2. 打开开发工具:Cmd+Option+I(Mac)或Ctrl+Shift+I(Windows/Linux)
  3. 进入 Network 标签页
  4. 刷新页面或等待refreshToken请求
  5. 复制请求/响应中的refresh_token值

2.配置MCP

添加到你的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

同步模型

  • v5 实体(tasks、events、tags、labels、time_slots、calendars)在本地缓存并用每个实体的 sync_token 刷新

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

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.

在 GitHub 查看完整 README

安装

npx -y @shrimpwtf/mcp-akiflow@latest
新手?先看 mcpskill.org 教程 →

配置

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