AM

aplaceforallmystuff/mcp-fantastical

开发工具

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

18 stars 12 forks 质量 76 趋势 30MIT

用于神奇日历应用的 MCP 服务器 - 创建事件、查看日历以及管理调度

概览

神奇的MCP服务器 - macOS的强大的日历应用. -使用"神奇"的强大自然语言解析("明天下午3点与约翰相会") - - 检查今天的事件或即将到来的预约而不离开您的谈话 - 跳入"神奇"中的任何日期 - 让克洛德理解您的可用性和日程背景 - - 用你现有的"神奇"和"日历"设置工作 - macOS (Fantastical is macOS- only) - Node.js 18+ - 神奇地安装 - 日历访问权限 终端/Claude 没有需要的 API 密钥 - 此服务器使用 AppleScript 来与 Fantrainal 和 Calendar app 通信 。 :~/图书馆/应用程序支持/Claude/claude desktop config.json 在首跑时,您可能需要获得以下许可: 1. 系统首选 → 隐私和安全 → 可访问性 2. 在允许的列表中添加终端(或您的终端应用) 土生土长的帮手船作为临时署名的.app 捆绑 (Fantastical helper.app).

概述(AI 翻译)

神奇的MCP服务器 - macOS的强大的日历应用.

□为什么用这个?

  • 自然语言事件创作 - 使用神奇的强大自然语言解析(“明天下午3点与约翰相会”)
  • 检查你的行程** - 检查今天的事件或即将到来的预约,而不离开你的谈话
  • 快速日历访问** - 立即跳到神奇中的任何日期
  • 让克洛德了解你的可用性和时间安排背景
  • 零配置 - 用您现有的奇异和日历设置工作

□ 特性

  • 类别 * 能力 * |-|-.
  • ** Event Create ** * * 使用自然语言创建事件,指定日历,并添加注释 * * ################################################################################################################################################################################################################################################################ ################################################################################################################################################################################################################################################################
        • 按标题、地点或注释开列的搜索事件 * * * ** Calendar 管理 ** 列出所有可用的日历 * **

□ 先决条件

  • macOS(只有教会教会)
  • 节点.js 18+
  • 神奇的安装
  • 终端/终端的日历访问权限

□ 安装

使用 npm( 建议)

QQ 来自源代码

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

README

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

MCP Fantastical Server

MCP server for Fantastical - the powerful calendar app for macOS.

Why Use This?

  • Natural language event creation - Use Fantastical’s powerful natural language parsing (“Meeting with John tomorrow at 3pm”)
  • View your schedule - Check today’s events or upcoming appointments without leaving your conversation
  • Quick calendar access - Jump to any date in Fantastical instantly
  • Calendar-aware AI - Let Claude understand your availability and schedule context
  • Zero configuration - Works with your existing Fantastical and Calendar setup

Features

Category Capabilities
Event Creation Create events using natural language, specify calendar, add notes
Schedule Viewing View today’s events, upcoming events for any number of days
Navigation Open Fantastical to specific dates
Search Search events by title, location, or notes
Calendar Management List all available calendars

Prerequisites

  • macOS (Fantastical is macOS-only)
  • Node.js 18+
  • Fantastical installed
  • Calendar access permissions for Terminal/Claude

Installation

npx mcp-fantastical

From Source

git clone https://github.com/aplaceforallmystuff/mcp-fantastical.git
cd mcp-fantastical
npm install
npm run build

Configuration

No API keys required - this server uses AppleScript to communicate with Fantastical and the Calendar app.

For Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fantastical": {
      "command": "npx",
      "args": ["-y", "mcp-fantastical"]
    }
  }
}

For Claude Code

Add to ~/.claude.json:

{
  "mcpServers": {
    "fantastical": {
      "command": "npx",
      "args": ["-y", "mcp-fantastical"]
    }
  }
}

Permissions

On first run, you may need to grant the following permissions:

Accessibility (for event creation via URL scheme):

  1. System Preferences → Privacy & Security → Accessibility
  2. Add Terminal (or your terminal app) to the allowed list

Full Calendar Access (for reading events):

在 GitHub 查看完整 README

安装

npx -y mcp-fantastical
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "fantastical": { "command": "npx", "args": ["-y", "mcp-fantastical"] } } }