### create_project Source: https://docs.lilys.ai/en/mcp-server/tools Registers one source and starts analysing it. This is what costs you. ```APIDOC ## create_project ### Description Registers one source and starts analysing it. This is what costs you. ### Method MCP Tool Call ### Endpoint create_project ### Parameters #### Request Body - **source** (string) - Required - The source to analyse. Can be a URL (for links) or an upload slot id returned by `prepare_upload`. ### Response #### Success Response - **project_id** (string) - The id of the created project. ### Notes - This is the operation that costs you. - For local files, use the id returned by `prepare_upload` as the source. - For links, pass the URL directly. ``` -------------------------------- ### Install Lily's MCP server via plugin Source: https://docs.lilys.ai/en/mcp-server/connect/claude-code Use these commands inside Claude Code to install the plugin, which installs the same server along with its skill. After installation, run `/mcp` to sign in. ```claude /plugin marketplace add teamlilysai/lilysai-plugin /plugin install lilysai@lilysai ``` -------------------------------- ### Install plugin in Codex Source: https://docs.lilys.ai/en/plugin Adds the plugin marketplace, installs the plugin, and logs in via MCP. The plugin ships a manifest, so no separate 'codex mcp add' step is needed. ```bash codex plugin marketplace add teamlilysai/lilysai-plugin codex plugin add lilysai@lilysai codex mcp login lilysai ``` -------------------------------- ### Prompt to paste to an agent for LilysAI MCP setup Source: https://docs.lilys.ai/en/mcp-server Paste this prompt to an agent to set up the LilysAI MCP server automatically. It instructs the agent to configure the remote server and ask you to approve the browser login. ```text Connect me to my LilysAI account over MCP so you can make notes from the links and files I give you, and read the notes I already have. Server (remote, streamable HTTP): https://mcp.lilys.ai/mcp It uses OAuth — I will be asked to sign in to LilysAI and approve access the first time. There is no API key. Set it up, then tell me to approve the browser login. ``` -------------------------------- ### prepare_upload Source: https://docs.lilys.ai/en/mcp-server/tools Gets an upload slot for a local file. Use the id it returns as a source. ```APIDOC ## prepare_upload ### Description Gets an upload slot for a local file. Use the id it returns as a source. ### Method MCP Tool Call ### Endpoint prepare_upload ### Parameters #### Request Body - **file** (file) - Required - The local file to upload. Supported extensions: pdf, docx, pptx, ppt, hwp, hwpx, jpg, jpeg, png, mp4, mov, webm, mp3, m4a, wav. Anything else returns `invalid_request` before uploading a byte. ### Response #### Success Response - **upload_slot_id** (string) - The id to use as a source in `create_project`. ### Notes - A local file takes two calls: `prepare_upload` returns an upload slot; put the file there, then hand the id it gave you to `create_project` as its source. - Links do not need this. Pass the URL straight to `create_project`. - The extension decides how the file is read, so keep the real one on the name. - Plain text is not a file here. Paste it as a text source instead. - Spreadsheets are not accepted over MCP. ``` -------------------------------- ### get_project Source: https://docs.lilys.ai/en/mcp-server/tools Returns one project: its source, and the notes made over it. ```APIDOC ## get_project ### Description Returns one project: its source, and the notes made over it. ### Method MCP Tool Call ### Endpoint get_project ### Parameters #### Path Parameters - **project_id** (string) - Required - The id of the project to retrieve. Ids are returned by the tools themselves; pass them back exactly as given. ### Response #### Success Response - **project** (object) - The project details, including its source and notes. ``` -------------------------------- ### create_note Source: https://docs.lilys.ai/en/mcp-server/tools Writes a note over a project's source. `style` sets its length and difficulty. ```APIDOC ## create_note ### Description Writes a note over a project's source. `style` sets its length and difficulty. ### Method MCP Tool Call ### Endpoint create_note ### Parameters #### Request Body - **project_id** (string) - Required - The id of the project whose source the note is written over. - **style** (string) - Required - Sets the note's length and difficulty. ### Response #### Success Response - **note_id** (string) - The id of the created note. ``` -------------------------------- ### get_account Source: https://docs.lilys.ai/en/mcp-server/tools Returns the user's plan, remaining allowance, and credit balance. No personal details. ```APIDOC ## get_account ### Description Returns the user's plan, remaining allowance, and credit balance. No personal details. ### Method MCP Tool Call ### Endpoint get_account ### Response #### Success Response - **plan** (string) - The user's plan. - **remaining_allowance** (number) - Remaining allowance. - **credit_balance** (number) - Credit balance. ``` -------------------------------- ### Add and login to Lily's MCP server in Codex Source: https://docs.lilys.ai/en/mcp-server/connect/codex Adds the Lily's MCP server to Codex and opens a browser window for approval. The server is available in Codex CLI, the IDE extension, and the ChatGPT desktop app. ```bash codex mcp add lilys --url https://mcp.lilys.ai/mcp codex mcp login lilys ``` -------------------------------- ### list_projects Source: https://docs.lilys.ai/en/mcp-server/tools Returns the user's projects, newest first. Supports filtering and paging with a cursor. ```APIDOC ## list_projects ### Description Returns the user's projects, newest first. Supports filtering and paging with a cursor. ### Method MCP Tool Call ### Endpoint list_projects ### Parameters #### Query Parameters - **cursor** (string) - Optional - Opaque cursor for paging. Pass back the cursor returned by a previous call to get the next page. ### Response #### Success Response - **projects** (array) - List of projects, newest first. - **cursor** (string) - Opaque cursor for the next page, if more results are available. ### Notes - Cursors are opaque; do not build or edit them. ``` -------------------------------- ### Add MCP server via terminal Source: https://docs.lilys.ai/en/mcp-server/connect/claude-code Run this command in your terminal to add the Lily's MCP server to Claude Code. After adding, run `/mcp` inside Claude Code, select 'lilys', and choose 'Authenticate' to approve the connection in a browser window. ```bash claude mcp add --transport http lilys https://mcp.lilys.ai/mcp ``` -------------------------------- ### save_project Source: https://docs.lilys.ai/en/mcp-server/tools Renames, moves or trashes a project. ```APIDOC ## save_project ### Description Renames, moves or trashes a project. ### Method MCP Tool Call ### Endpoint save_project ### Parameters #### Request Body - **project_id** (string) - Required - The id of the project to modify. - **new_name** (string) - Optional - New name for the project. - **new_location** (string) - Optional - New location (folder) for the project. - **trash** (boolean) - Optional - Whether to trash the project. ### Response #### Success Response - **success** (boolean) - Whether the operation succeeded. ``` -------------------------------- ### save_collection Source: https://docs.lilys.ai/en/mcp-server/tools Creates, renames, moves or trashes a folder. ```APIDOC ## save_collection ### Description Creates, renames, moves or trashes a folder. ### Method MCP Tool Call ### Endpoint save_collection ### Parameters #### Request Body - **collection_id** (string) - Optional - The id of the collection to modify. Omit to create a new collection. - **new_name** (string) - Optional - New name for the collection. - **new_location** (string) - Optional - New location (parent folder) for the collection. - **trash** (boolean) - Optional - Whether to trash the collection. ### Response #### Success Response - **success** (boolean) - Whether the operation succeeded. ``` -------------------------------- ### list_memos Source: https://docs.lilys.ai/en/mcp-server/tools Returns notes the user wrote themselves, as opposed to ones the AI wrote. ```APIDOC ## list_memos ### Description Returns notes the user wrote themselves, as opposed to ones the AI wrote. ### Method MCP Tool Call ### Endpoint list_memos ### Response #### Success Response - **memos** (array) - List of user-written notes. ``` -------------------------------- ### get_transcript Source: https://docs.lilys.ai/en/mcp-server/tools Returns the text of one source. Also polls while a source is being analysed. ```APIDOC ## get_transcript ### Description Returns the text of one source. Also polls while a source is being analysed. ### Method MCP Tool Call ### Endpoint get_transcript ### Parameters #### Path Parameters - **source_id** (string) - Required - The id of the source to retrieve. ### Response #### Success Response - **transcript** (string) - The text of the source. Capped at 40,000 characters. If longer, the response indicates truncation and includes a link to the full text on the web. ### Notes - The body is capped at 40,000 characters. When longer, the response says so and carries a link to the full text on the web. Follow the link rather than asking for the body again. ``` -------------------------------- ### list_collections Source: https://docs.lilys.ai/en/mcp-server/tools Returns the folder tree of collections. ```APIDOC ## list_collections ### Description Returns the folder tree of collections. ### Method MCP Tool Call ### Endpoint list_collections ### Response #### Success Response - **collections** (array) - The folder tree. ``` -------------------------------- ### get_note Source: https://docs.lilys.ai/en/mcp-server/tools Returns a note's body. Also serves as the polling call while a note is being written. ```APIDOC ## get_note ### Description Returns a note's body. Also serves as the polling call while a note is being written. ### Method MCP Tool Call ### Endpoint get_note ### Parameters #### Path Parameters - **note_id** (string) - Required - The id of the note to retrieve. ### Response #### Success Response - **body** (string) - The note's body. Capped at 40,000 characters. If longer, the response indicates truncation and includes a link to the full text on the web. ### Notes - The body is capped at 40,000 characters. When longer, the response says so and carries a link to the full text on the web. Follow the link rather than asking for the body again. ``` -------------------------------- ### list_highlights Source: https://docs.lilys.ai/en/mcp-server/tools Returns passages the user marked while reading. ```APIDOC ## list_highlights ### Description Returns passages the user marked while reading. ### Method MCP Tool Call ### Endpoint list_highlights ### Response #### Success Response - **highlights** (array) - List of highlighted passages. ``` -------------------------------- ### Claude Code MCP server URL Source: https://docs.lilys.ai/en/mcp-server The MCP server URL to use for connecting any MCP client to LilysAI. Sign-in is automatic via OAuth on first use; no API key is needed. ```text https://mcp.lilys.ai/mcp ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.