Notejoy MCP

Notejoy's MCP server enables you to connect Notejoy to your favorite AI tools.

Doing so allows you to easily read, create, and edit notes all from the convenience of your favorite chatbot or agent. It's never been faster to find information, summarize notes, or save artifacts to your favorite notes app.

Ways To Use

Create - Generate PRDs, tech specs, and architecture docs from your research and project data
Search - Let AI search across all of your Notejoy notes
Summarize - Ask AI to summarize individual notes, an entire notebook, or based on a search
Collaborate - Unlike creating local markdown files, AI generated artifacts in Notejoy are automatically shared and editable by your team without having to know and learn Github
Skip markdown - While Notejoy MCP uses markdown underneath the covers, you never have to learn it, since you get rich text editing in Notejoy without the markdown syntax

Supported Chatbots & Agents

Notejoy MCP works in all your favorite chatbots and agents, including:

Claude
Claude Cowork
Claude Code
ChatGPT
ChatGPT Codex
Cursor
VS Code / GitHub Copilot
Google Antigravity
Google Antigravity CLI
and more...

Best Practices

Here are a few tips for getting the most out of Notejoy's MCP integration:

Just mentioning Notejoy in your prompt helps to ensure your agent invokes the relevant Notejoy tools. For example, prompts like "search notejoy for", "add to notejoy" are typically all you need to say.
If you want to reference a specific note, find the note in Notejoy, right-click, select Copy URL, and then paste that URL into your agent. You can then run prompts like "Summarize <note url>", "Save the findings to <note url>".
You can do the same thing for notebooks and libraries. Just right-click the notebook or library and select Copy URL. And then add that to your prompt. Useful for prompts like "Summarize all the notes in <notebook url>".
Of course, you can also just mention the note \ notebook \ library by name and your agent will browse Notejoy to find it. But the above approach is particularly helpful when you have duplicate names.
If you don't specify a notebook, notes will be created in your default notebook. To set a different default notebook, just right-click it in Notejoy and select "Make Default"
A Notejoy note is also a great way to iterate with AI on an artifact. You can create the note with your agent and then keep asking it to make updates, add sections, etc.

Supported Tools

Notejoy MCP provides the following 8 tools to your AI Agent:

notejoy-fetch - Get a specific note's metadata and content (markdown format)
notejoy-search - Search across all the Notejoy notes you have access to
notejoy-list-notes - List notes in a specific notebook
notejoy-list-notebooks - List notebooks in a specific library
notejoy-list-libraries - List all the libraries and notebooks you have access to
notejoy-create-note - Create a new note with title and content (markdown format)
notejoy-edit-note - Edit an existing notes title or content (markdown format)
notejoy-get-user - Get the current user's name, email, and plan type

Getting Started

Here's how to connect Notejoy in each of the popular AI tools.

Claude / Claude Cowork

Select Customize from the sidebar
Select Connectors
Press the + button, select Add custom connector
Set the Name to: Notejoy
Set the Remote MCP server URL to: https://mcp.notejoy.com/mcp
Press Add
Select Connect

Claude Code

Run the following command in your terminal:
claude mcp add --transport http notejoy https://mcp.notejoy.com/mcp
Start claude
Type /mcp, select Notejoy, and then select authenticate

ChatGPT

Select Apps in the sidebar
Press the gear icon in the top-right corner
Press Advanced Settings
Enable Developer mode
Press Create app
Set Name to: Notejoy
Set Connection to: https://mcp.notejoy.com/mcp
Press Create
Press Sign in with Notejoy

ChatGPT Codex

Select Settings - Settings
Select MCP servers
Select + Add server
Set Name to: Notejoy
Select Streamable HTTP
Set URL to: https://mcp.notejoy.com/mcp
Press Save
Press Authenticate

Cursor

Select Gear icon in the top-right corner
Select Tools & MCPs
Select Add Custom MCP

Paste the following into mcp.json:

{
  "mcpServers": {
    "notejoy": {
      "url": "https://mcp.notejoy.com/mcp"
    }
  }
}

Close mcp.json
Select Connect

VS Code / GitHub Copilot

Select View - Command Palette...
Type MCP: Add Server...
Select HTTP
Enter URL: https://mcp.notejoy.com/mcp
Authenticate to Notejoy

Google Antigravity

Select the ... menu in the agent sidebar
Select MCP Servers
Select Manage MCP Servers
Select View raw config

Paste the following into mcp_config.json

{
  "mcpServers": {
    "notejoy": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.notejoy.com/mcp"
      ]
    }
  }
}

Close mcp_config.json
You'll be prompted in your browser to authenticate with Notejoy

Google Antigravity CLI

Open ~/.gemini/config/mcp_config.json

Paste the following and save

{
  "mcpServers": {
    "notejoy": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.notejoy.com/mcp"
      ]
    }
  }
}

Run agy
Type /mcp
Select Notejoy to authenticate

Other Tools

The Notejoy MCP server is broadly supported by a variety of MCP clients even beyond the ones listed above. You'll need the following information to configure Notejoy's MCP server in your custom client:

MCP Server URL: https://mcp.notejoy.com/mcp
Transport: Streamable HTTP
Authentication: Browser-based OAuth 2.0 with Dynamic Client Registration