Se você usa o Joplin para organizar anotações e o OpenCode para trabalhar com IA no terminal, é possível conectar os dois usando o MCP (Model Context Protocol).

Criei um pequeno projeto para facilitar essa integração:

OpenCode Joplin MCP:https://github.com/pedropaulonet/opencode-joplin-mcp

Com ele, o OpenCode consegue acessar suas notas do Joplin e executar tarefas como:

• listar seus notebooks;
• pesquisar notas;
• ler o conteúdo das notas;
• criar novas notas;
• editar notas existentes.

Por exemplo, você pode pedir diretamente no OpenCode:

Liste meus notebooks do Joplin.

Procure minhas anotações sobre meu projeto XYZ.

Crie uma nota chamada "Dicas Linux" com uma lista de comandos úteis.

Adicione esta dica ao meu notebook "PedroPaulo.net".

Como funciona

A integração utiliza a API Web Clipper do Joplin, normalmente disponível localmente na porta 41184.

O OpenCode inicia o servidor MCP e passa a utilizar o Joplin como uma de suas ferramentas. Assim, o modelo de IA pode consultar ou alterar suas notas quando necessário.

O token de acesso do Joplin fica armazenado localmente em um arquivo .env e não precisa ser colocado diretamente na configuração do OpenCode.

Instalação

Clone o projeto:

git clone https://github.com/pedropaulonet/opencode-joplin-mcp.git
cd opencode-joplin-mcp

No Joplin, acesse:

Ferramentas → Opções → Web Clipper

Ative o serviço e copie o token de autorização.

Depois execute:

./setup.sh

Edite o arquivo .env criado e informe o token do Joplin.

Abra essa pasta no OpenCode, reinicie o OpenCode e execute:

/mcps

O servidor joplin deverá aparecer na lista.

E qual IA utilizar?

Nos meus testes utilizei modelos através do OpenRouter, inclusive modelos gratuitos.

O MCP, porém, não depende do OpenRouter. O modelo é escolhido no próprio OpenCode.

Se você possui uma boa placa de vídeo, também pode utilizar um modelo local compatível com o OpenCode, mantendo tanto suas notas quanto o processamento da IA na sua própria máquina.

Dessa forma, o Joplin deixa de ser apenas um aplicativo de anotações e passa a funcionar também como uma base pessoal de conhecimento acessível pela IA.