AI with FYINotes
Use AI with FYINotes Beta
Use the AI tools already in FYINotes, or connect the AI you already use so it can read and write the cloud pages you allow through MCP.
This page is in Beta. Sign in to use the built-in tools. To connect your own AI, use the public connector (sign in, no token) or the older token server (Settings → Get MCP Token, verified accounts). You choose which of your cloud pages a connected app can use. Skills tell your AI how to use those tools safely.
Built-in AI tools
Open AI Tools in the header. These tools need an account. Double-check what AI writes; it can be wrong.
Research
Start from a topic. FYINotes researches it, creates a page, and saves it to your cloud docs.
Think AI
Turn documents, pasted text, or images with text into a new page, or add the result to the page you have open.
FyiNotes AI
Ask, rewrite, summarize, make a checklist, or create a note page from a chat. You can save reusable prompts in this browser.
YT Channel Brief
Paste a YouTube channel, playlist, or video link. FYINotes lists videos and writes a short summary of each one, with a Watch link.
Page AI and Note AI
On an open page, ask for improvements, organization, or missing notes. On a selected note, ask to explain it, expand it, or give an example.
Connect your own AI with MCP
MCP lets your AI client call FYINotes page tools over HTTPS. You stay in Cursor, Claude, or another MCP app, and the pages land in your cloud docs. Use the public connector when your client can sign in with OAuth. Use the older token server when your client only accepts a pasted token, or when you need AI collab keys or the other token-server tools.
Public connector (sign in)
If your AI client supports OAuth connectors, add the public connector. You sign in to FYINotes in the browser. There is no token to paste. The app can create new pages (those are allowed automatically). It can only read and edit pages you allowed, plus pages it created. It can use only your own cloud pages, and it can't delete pages.
Set it up
- In an MCP client that supports OAuth connectors, add https://mcp.fyinotes.com/mcp as a remote server.
- When the client asks you to sign in, sign in to FYINotes and review the app on the Connect an app page.
- Under Pages it can use, tick the cloud pages the app may read and edit. A filter helps you find them. Nothing is ticked by default. You can allow none: the app can still create pages.
- Choose Allow. The browser returns you to the app.
Public connector endpoint
https://mcp.fyinotes.com/mcp
Cursor config example
Restart the AI client after you change this file. Then choose Connect and sign in.
{
"mcpServers": {
"fyi-pages-public": {
"url": "https://mcp.fyinotes.com/mcp"
}
}
}
To change access later, open a cloud page's Settings and use the Allow AI connectors switch, under Collab with AI. Or open Settings → AI connector access (or /connect-mcp) to turn each of your cloud pages on or off for every connected app at once. Only cloud pages appear; sync a browser-only page to the cloud first. There is no settings page yet to disconnect apps one by one, so turn pages off instead. An access token lasts up to 1 hour, and a refresh token up to 30 days.
Public connector how-to
https://fyinotes.com/MCP_api_svc.md
Token server (paste a token)
Set it up
- Sign in to FYINotes and verify your email from Settings.
- Open Settings and choose Get MCP Token. Copy the one token for your account.
- Add the FYI Pages MCP server to your AI client. Keep the trailing slash on the URL.
- Create a skill with one of the prompts below so your AI uses the native page tools.
MCP endpoint
https://api.fyinotes.com/mcp/
Cursor MCP config example
Put your token in an environment variable. Do not commit it. Restart the AI client after you change this file.
{
"mcpServers": {
"fyi-pages": {
"url": "https://api.fyinotes.com/mcp/",
"headers": {
"Authorization": "Bearer YOUR_MCP_TOKEN"
}
}
}
}
MCP page tools
https://fyinotes.com/MCP_Pages_svc.md
Skills
A skill is a short instruction file your AI loads when you ask it to work with FYINotes pages. In Cursor, save it as SKILL.md under .cursor/skills/ in a project or in your personal skills folder. Other AIs can use the same text as a custom instruction or project skill.
- On the public connector, use fyi_ping, list_my_pages, get_my_page, create_my_page, add_my_notes, and update_my_notes. Pass updt on writes.
- On the token server, prefer native tools: create_fyi_page, get_fyi_page, add_fyi_notes, and update_fyi_notes.
- Pass updt from the last read or write so you do not overwrite a newer cloud page.
- Use update_project_page only when you want the whole page rebuilt from markdown. That path replaces note ids. The public connector has no markdown rebuild tool.
- Read the public connector how-to at /MCP_api_svc.md, and the token-server page-tool how-to at /MCP_Pages_svc.md.
- Read the agent markdown spec at /fyi-page-instructions.md before creating a downloadable .fyi file.
Prompts to create the skills
Paste a prompt into your AI and ask it to save the result as a skill.
FYI Pages public connector skill
Creates a skill that uses the public connector (sign in, no token) to read and write the pages you allow.
Create a skill named fyi-pages-public.
When I work with FYINotes pages from an AI client that uses the public FYI connector, use that connector.
Include these rules in the skill:
- MCP server name: fyi-pages-public
- Endpoint: https://mcp.fyinotes.com/mcp (no trailing slash)
- Auth: OAuth sign-in in the browser. No token to paste.
- Tools: fyi_ping, list_my_pages, get_my_page, create_my_page, add_my_notes, update_my_notes.
- Always pass updt from the last read or write.
- The app can create new pages; pages it creates are allowed automatically. It can only read and edit pages I allowed plus pages it created. Only my own cloud pages. It cannot delete pages. Unallowed pages answer not_found and are omitted from list_my_pages.
- Note types: 1 text, 2 expandable, 3 large, 4 URL, 5 rule, 7 header, 11 JSON, 12 Mermaid.
- For the how-to, fetch https://fyinotes.com/MCP_api_svc.md.
- Before creating a local .fyi file, read the agent spec at https://fyinotes.com/fyi-page-instructions.md.
- Keep page content safe: no scripts, event handlers, iframes, forms, or invented URLs.
- Do not put passwords, secrets, or highly sensitive personal information on a page.
Save it as SKILL.md with YAML frontmatter name and description, then a markdown body the agent can follow.
FYI Pages MCP skill
Creates a skill that uses the token-based MCP server to read and write pages.
Create a skill named fyi-pages-mcp.
When I work with FYINotes pages from an AI client, use the FYI Pages MCP server.
Include these rules in the skill:
- MCP server name: fyi-pages
- Endpoint: https://api.fyinotes.com/mcp/ (trailing slash required)
- Auth: Authorization Bearer token from FYINotes Settings, Get MCP Token. Verified accounts only. One token per account.
- Prefer native tools: create_fyi_page, get_fyi_page, add_fyi_notes, update_fyi_notes.
- Use add_cloud_pin_notes only when I ask to pin something.
- Do not use update_project_page unless I explicitly want the whole page rewritten from markdown. That path destroys existing note ids.
- Always pass updt from the last read or write.
- Note types: 1 text, 2 expandable, 3 large, 4 URL, 5 rule, 7 header, 11 JSON, 12 Mermaid.
- For native JSON and markdown page tools, fetch https://fyinotes.com/MCP_Pages_svc.md.
- Before creating a local .fyi file, read the agent spec at https://fyinotes.com/fyi-page-instructions.md.
- Keep page content safe: no scripts, event handlers, iframes, forms, or invented URLs.
- Do not put passwords, secrets, or highly sensitive personal information on a page.
Save it as SKILL.md with YAML frontmatter name and description, then a markdown body the agent can follow.
.fyi page format skill
Creates a skill for valid .fyi JSON when you want a file instead of a live cloud page.
Create a skill named fyi-page-format.
When I ask you to create a .fyi file or an FYINotes page as a downloadable file, follow the official agent spec at:
https://fyinotes.com/fyi-page-instructions.md
Rules:
- Return only valid JSON. Do not wrap it in markdown.
- Use matching note ids in d and b.
- Prefer native MCP tools when the fyi-pages server is connected, instead of emitting a raw file, unless I ask for a file.
- Use page meta version 18, note version 12, and pub version 4.
- Use ty 7 for headers, 1 for text, 2 for expandable notes, 3 for long notes, 11 for JSON, and 12 for Mermaid.
- Keep the JSON safe: no scripts, event handlers, iframes, forms, or invented links.
.fyi page definition
AI tools, scripts, and skills that create pages outside the app should follow the official .fyi JSON definition. Agents should fetch the markdown spec.
https://fyinotes.com/fyi-page-instructions.md
Questions or feedback? Support.
FYINotes, keep good notes.