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 ", "Save the findings to ".
• 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 ".
• 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 note's 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

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

Claude Code

1. Run the following command in your terminal:

claude mcp add --transport http notejoy https://mcp.notejoy.com/mcp

2. Start claude
3. Type /mcp, select Notejoy, and then select authenticate

ChatGPT

1. Select Apps in the sidebar
2. Press the gear icon in the top-right corner
3. Press Advanced Settings
4. Enable Developer mode
5. Press Create app
6. Set Name to: Notejoy
7. Set Connection to: https://mcp.notejoy.com/mcp
8. Press Create
9. Press Sign in with Notejoy

ChatGPT Codex

1. Select Settings - Settings
2. Select MCP servers
3. Select + Add server
4. Set Name to: Notejoy
5. Select Streamable HTTP
6. Set URL to: https://mcp.notejoy.com/mcp
7. Press Save
8. Press Authenticate

Cursor

1. Select Gear icon in the top-right corner
2. Select Tools & MCPs
3. Select Add Custom MCP
4. Paste the following into mcp.json:

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

5. Close mcp.json
6. Select Connect

VS Code / GitHub Copilot

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

Google Antigravity

1. Select the ... menu in the agent sidebar
2. Select MCP Servers
3. Select Manage MCP Servers
4. Select View raw config
5. Paste the following into mcp_config.json:

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

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

Google Antigravity CLI

1. Open ~/.gemini/config/mcp_config.json
2. Paste the following and save

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

3. Run agy
4. Type /mcp
5. 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