Nuwa Pen AI Connector (MCP)

How it works

The connector uses the Model Context Protocol (MCP) to give your AI assistant secure, read-only access to your note transcriptions. It cannot modify, delete, or create notes — it can only read them.

When you ask the AI something about your notes, it calls the Nuwa API on your behalf, fetches the relevant transcriptions, and uses them to answer your question.

Getting started

Claude (Anthropic)

1. Go to Settings → Connectors

2. Search for Nuwa Pen and click Connect

3. Sign in with your Nuwa account (the same email and password you use in the Nuwa+ app)

That's it — start asking Claude about your notes.

ChatGPT (OpenAI)

1. Go to Apps

2. Search for Nuwa and click Connect

3. Sign in with your Nuwa account

4. Once connected, make sure the Nuwa Pen toggle is on when chatting

That's it — start asking ChatGPT about your notes.

Cursor

1. Open Cursor Settings → MCP

2. Click Add new MCP server

3. Set the URL to https://mcp.nuwapen.com/

4. Choose Streamable HTTP as the transport

5. Authenticate with your Nuwa account when prompted

n8n and other automation tools

Some apps (like n8n) can't complete the standard OAuth sign-in. For these, use a personal access token instead:

1. Go to https://mcp.nuwapen.com/token in your browser

2. Sign in with your Nuwa account

3. Copy the access token shown

Then in n8n:

1. Add the MCP Client Tool node to an AI Agent workflow

2. Endpoint: https://mcp.nuwapen.com/

3. Server Transport: HTTP Streamable

4. Authentication: Bearer — paste your token

Treat the token like a password — anyone who has it can read your notes. It stays valid for up to 90 days; revisit the token page to get a fresh one.

Other MCP-compatible apps

Any app that supports MCP over Streamable HTTP can connect using:

• Server URL: https://mcp.nuwapen.com/

• Authentication: OAuth 2.0 — or a personal access token from https://mcp.nuwapen.com/token if your app only supports bearer/header authentication

What you can do

Recall recent writing

• "What did I write today?"

• "Show me my notes from this morning"

The AI fetches your recent notes and summarises what you've written, organised by time.

Search across notebooks

• "Find my notes about the product roadmap"

• "Do I have any notes mentioning Sarah's feedback?"

Searches across all transcription fields — the pen uses multiple OCR engines, so even messy handwriting is searchable.

See your actual handwriting

• "Show me my last note as an image"

• "Render the note about the budget as handwriting"

The AI displays your original pen strokes as an image, so you can see exactly what the page looked like — useful when the transcription misses something like a sketch or diagram.

Summarise a notebook

• "Summarise everything in my Meeting Notes notebook"

• "What are the key themes in my Research canvas?"

The AI lists your notebooks, pulls all notes from the one you specify, and produces a structured summary.

Look at a specific time window

• "What did I write during Tuesday's 2pm meeting?"

• "Give me a digest of everything I wrote this week"

The AI can fetch notes from an exact time range and organise them day-by-day.

Check your stats

• "How many notes have I written in the last month?"

Returns note counts, date ranges, and a breakdown by status (active, archived, trashed).

Available tools

The connector provides 9 read-only tools:

Archived & trashed notes

By default, archived and trashed notes are excluded from results. If you want to include them, just ask:

• "Show me my trashed notes"

• "Search my archived notes for project plans"

The AI will include them when you explicitly ask.

Privacy & security

• Read-only access — the connector cannot modify, delete, or create notes

• No note content is stored — transcriptions are fetched on-demand and passed directly to the AI assistant. The connector does not cache or log your note content.

• Encrypted — all communication uses HTTPS/TLS

• Your credentials are safe — authentication uses OAuth 2.0. Your password is never shared with or stored by the AI assistant.

• Personal access tokens are shown once, only to you, and expire automatically after 90 days

• Session persistence — you stay logged in across sessions without needing to re-authenticate

• Revoke anytime — disconnect the connector in your AI assistant's settings to immediately revoke access

For full details, see our Privacy Policy.

Requirements

• A Nuwa Pen with notes synced to the cloud via the Nuwa+ app

• A Nuwa account (free or paid — both work)

• An AI assistant that supports MCP (e.g. Claude Pro, ChatGPT, Cursor, n8n)

No special permissions, admin access, or developer setup required. Available globally.

Troubleshooting

"No notes found"

• Make sure your notes are synced in the Nuwa+ app. The connector reads from the cloud, not directly from the pen.

• Try asking for a wider time range: "Show me notes from the last week"

"Authentication failed"

• Verify you're using the same email and password as the Nuwa+ app

• If you use Google Sign-In in the app, use the Continue with Google option on the login page

• Try disconnecting and reconnecting the connector

"Insufficient parameters" or "code_challenge required" during connect

Your app's OAuth implementation doesn't support the security standard (PKCE) that the connector requires. This affects n8n and some other automation tools. Use a personal access token instead — see n8n and other automation tools above.

"Session expired"

This shouldn't happen under normal use — sessions auto-refresh. If it does:

1. Disconnect the connector in your AI assistant's settings

2. Reconnect and sign in again

If you connected with a personal access token, tokens expire after ~90 days — visit https://mcp.nuwapen.com/token to get a new one.

Connection seems slow

The first request after connecting may take a few seconds as the session is established. Subsequent requests are faster.

Support

Having trouble? We're here to help.

• Email: marc@nuwapen.com

• Support center: support.nuwapen.com