---
name: Bug Report
about: Create a report to help us improve
title: '[BUG] '
labels: ['bug']
assignees: ''
---
## 🐛 Bug Description
A clear and concise description of what the bug is.
## 🔄 Steps to Reproduce
Steps to reproduce the behavior:
1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error
## ✅ Expected Behavior
A clear and concise description of what you expected to happen.
## ❌ Actual Behavior
A clear and concise description of what actually happened.
## 📸 Screenshots
If applicable, add screenshots to help explain your problem.
## 🖥️ Environment Information
**Desktop:**
- OS: [e.g. macOS 13.0, Windows 11, Ubuntu 22.04]
- Node.js version: [e.g. 18.17.0]
- npm version: [e.g. 9.6.7]
**Joplin:**
- Joplin version: [e.g. 2.12.18]
- Web Clipper port: [e.g. 41184]
- API Token used: [Yes/No]
**MCP Joplin Server:**
- Version: [e.g. 0.0.1]
- Installation method: [npm install -g, npx, local development]
## 📋 Error Logs
Please include any relevant error messages or logs:
```
Paste error logs here
```
## 🔧 Configuration
**MCP Client Configuration (if applicable):**
```json
{
"mcpServers": {
"joplin": {
// Your configuration here
}
}
}
```
**Command Used:**
```bash
# The exact command you ran that caused the issue
```
## 🤔 Additional Context
Add any other context about the problem here.
## ✅ Checklist
- [ ] I have searched existing issues to avoid duplicates
- [ ] I have tested with the latest version
- [ ] Joplin Desktop is running and Web Clipper is enabled
- [ ] I have included all relevant information above
