Content
# Tool List
Yinxiang / Evernote China's MCP server. Provides note read and write tools through stdio, supporting Markdown and ENML conversion.
## Installation
```bash
npx -y @__shiyi/yinxiang-mcp
```
## Authentication
Direct Token mode, does not use OAuth. Requires two environment variables:
- `YINXIANG_DEV_TOKEN` — Developer Token, apply at <https://dev.yinxiang.com>
- `YINXIANG_NOTESTORE_URL` — NoteStore URL, e.g. `https://app.yinxiang.com/shard/s68/notestore`
## Integrating with Claude
```json
{
"mcpServers": {
"yinxiang": {
"command": "npx",
"args": ["-y", "@__shiyi/yinxiang-mcp"],
"env": {
"YINXIANG_DEV_TOKEN": "<token>",
"YINXIANG_NOTESTORE_URL": "https://app.yinxiang.com/shard/sXX/notestore"
}
}
}
}
```
## Tools
- `list-notebooks` — List notebooks
- `find-notes` (`words`, `notebookGuid`, `maxResults`) — Search notes
- `create-note` (`title`, `content`, `notebookGuid`) — Create a new note, Markdown to ENML
- `get-note` (`guid`) — Read a note, ENML to Markdown
## Local Development
```bash
npm install
cp .env.example .env
npm run verify # Connectivity verification
npm run test-rw # Read and write round-trip test
npm start
```
## Limitations
- `evernote@2.0.5`, EDAM API is relatively old
- Markdown conversion covers basic syntax; task lists and attachments are not supported yet
- MIT