Apple Notes to Ramifica

Push selected Apple Notes content into any Ramifica list using Apple Shortcuts and the MCP API. Works on iPhone, iPad, and Mac.

How It Works

  1. Select text in Apple Notes and tap Share.
  2. The shortcut sends the text to Ramifica's MCP API.
  3. Content appears as items in your chosen Ramifica list.

Setup Guide

Step 1: Get Your MCP Token

Go to your account settings and open API Tokens. Create a token with read+write scope for the workspace containing the target list. Copy the token immediately — it is shown only once.

Step 2: Find Your Target List Name

The shortcut uses add_items with a listName parameter. Open Ramifica, navigate to the list you want to send notes to, and note its exact name. Or omit the list name to send to your Inbox (auto-created if it does not exist).

Step 3: Create the Shortcut

Open the Shortcuts app on Mac or iPhone. Create a new shortcut that accepts Text from the Share Sheet. Add a "Get Contents of URL" action configured as follows:

  • URL: https://ramifica.app/api/mcp
  • Method: POST
  • Headers: Content-Type: application/json, Authorization: Bearer YOUR_TOKEN
  • Request Body (JSON):
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "add_items",
    "arguments": {
      "listName": "YOUR_LIST_NAME",
      "items": [{ "content": "PROVIDED_INPUT", "depth": 0 }]
    }
  }
}

In the Shortcuts app, use the "Shortcut Input" variable for the content field and ask-each-time or saved Text variables for the token and list name.

On success the API returns: { "added": 1, "listId": "..." }

Download Shortcut

A pre-built shortcut will be available for download soon. In the meantime, follow the manual setup above.

Tips

  • To send multiple paragraphs as separate items, the shortcut can split text by newlines and map each to an items array entry with increasing depth.
  • Rate limit: 20 requests per minute per token.
  • Max items: 50 items per add_items call.