About Noteit MCP
An independently maintained hosted MCP service for reading and managing AI agent profiles and project notes, plus generating HTML notes and flow diagrams.
What you can use it for
- Retrieve reusable agent profiles and instructions.
- Search project notes and tasks.
- Create structured notes or flow diagrams from project context.
Connection and setup
- Hosting
- remote, hosted
- Transport
- Streamable HTTP
- Endpoint
- https://www.noteit-mcp.com/api/mcp
- Authentication
- OAuth 2.1 with device fingerprint for supporting IDEs; optional API token for other clients. The README says Cursor OAuth is automatic and Gemini CLI uses /mcp auth. Do not send account passwords in chat.
Requirements
- Create/login to a Noteit account through OAuth.
- Use an MCP client supporting remote HTTP; OAuth support varies by client.
- For clients without the documented OAuth flow, obtain an API token after login and store it securely.
Setup steps
- Add the remote endpoint https://www.noteit-mcp.com/api/mcp to the selected MCP client.
- For Cursor, repository docs show the URL in ~/.cursor/mcp.json, then restart Cursor; OAuth is handled automatically per README.
- For Claude Code, use claude mcp add --transport http noteit-mcp https://www.noteit-mcp.com/api/mcp; project scope is also documented with -s project.
- For Gemini CLI, run gemini mcp add --transport http noteit-mcp https://www.noteit-mcp.com/api/mcp, then authenticate with /mcp auth noteit-mcp and inspect /mcp.
- For other IDEs, the repository directs users to log in at the Noteit website and obtain an API token. Keep the token in local secret storage, never in chat or committed config.
- Verify using a harmless read-only action such as listing profiles or notes. Creating/generating notes and profiles changes stored account data.
Tools
The current official Noteit MCP repository lists exactly eight tools. This is Noteit-MCP (personal agent profiles and developer notes), not Notit (the separate study-material service).
- 01
noteit_profiles_listList user agent profiles and their composable instructions.
- 02
noteit_profiles_getConfigRetrieve a composable agent configuration profile.
- 03
noteit_profiles_generateGenerate and save profile components such as personas, rules, documents or instructions.
- 04
noteit_notes_createCreate project notes, tasks, explanations or issue records.
- 05
noteit_notes_readRead a note by its unique ID.
- 06
noteit_notes_listBrowse and filter notes by tags, record type or project.
- 07
noteit_web_createCreate interactive HTML notes.
- 08
noteit_flow_createCreate visual flow diagrams.
Limitations and notes
- Account OAuth required to use the hosted service.
- API token path is for other clients; exact token scopes/expiry are not listed in the README.
- Creating notes, profiles, HTML pages and diagrams writes to the account.
- No schemas for tool input/output are published in the README.
- No runtime connection test performed.
Source discrepancies
- Repository describes OAuth 2.1 with device fingerprint for supported IDEs and optional API tokens for others, but does not give token scope/expiry details.
- README promotes 60+ expert personas; this describes agent-profile templates, not 60+ MCP tools.
Original sources
- official repository tool reference
Current publisher repository enumerates eight exact tools and documents endpoint https://www.noteit-mcp.com/api/mcp with OAuth 2.1 and optional API-token authentication.
- official product page
Publisher product page describes reusable AI profiles, notes and visualization workflows.
Documentation checked 2026-10-28T13:56:00.000Z. Connection has not been runtime tested.
Views
07 days
Platforms
Remote · Streamable HTTP
remote, hosted
Authentication
OAuth 2.1 with device fingerprint for supporting IDEs; optional API token for other clients. The README says Cursor OAuth is automatic and Gemini CLI uses /mcp auth. Do not send account passwords in chat.






